selenium-webdriver 2.48.2 → 2.52.0

package/lib/goog/json/json.js

@@ -1,363 +0,0 @@
-// 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 JSON utility functions.
- * @author arv@google.com (Erik Arvidsson)
- */
-
-
-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.
- */
-goog.json.isValid = function(s) {
-  // All empty whitespace is not valid.
-  if (/^\s*$/.test(s)) {
-    return false;
-  }
-
-  // This is taken from http://www.json.org/json2.js which is released to the
-  // public domain.
-  // Changes: We dissallow \u2028 Line separator and \u2029 Paragraph separator
-  // inside strings.  We also treat \u2028 and \u2029 as whitespace which they
-  // are in the RFC but IE and Safari does not match \s to these so we need to
-  // include them in the reg exps in all places where whitespace is allowed.
-  // We allowed \x7f inside strings because some tools don't escape it,
-  // e.g. http://www.json.org/java/org/json/JSONObject.java
-
-  // Parsing happens in three stages. In the first stage, we run the text
-  // against regular expressions that look for non-JSON patterns. We are
-  // especially concerned with '()' and 'new' because they can cause invocation,
-  // and '=' because it can cause mutation. But just to be safe, we want to
-  // reject all unexpected forms.
-
-  // We split the first stage into 4 regexp operations in order to work around
-  // crippling inefficiencies in IE's and Safari's regexp engines. First we
-  // replace all backslash pairs with '@' (a non-JSON character). Second, we
-  // replace all simple value tokens with ']' characters. Third, we delete all
-  // open brackets that follow a colon or comma or that begin the text. Finally,
-  // we look to see that the remaining characters are only whitespace or ']' or
-  // ',' or ':' or '{' or '}'. If that is so, then the text is safe for eval.
-
-  // Don't make these static since they have the global flag.
-  var backslashesRe = /\\["\\\/bfnrtu]/g;
-  var simpleValuesRe =
-      /"[^"\\\n\r\u2028\u2029\x00-\x08\x0a-\x1f]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g;
-  var openBracketsRe = /(?:^|:|,)(?:[\s\u2028\u2029]*\[)+/g;
-  var remainderRe = /^[\],:{}\s\u2028\u2029]*$/;
-
-  return remainderRe.test(s.replace(backslashesRe, '@').
-      replace(simpleValuesRe, ']').
-      replace(openBracketsRe, ''));
-};
-
-
-/**
- * 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.
- *
- * @param {*} s The JSON string to parse.
- * @throws Error if s is invalid JSON.
- * @return {Object} The object generated from the JSON string, or null.
- */
-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);
-    };
-
-
-/**
- * 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.
- *
- * @param {string} s The JSON string to parse.
- * @return {Object} The object generated from the JSON string.
- */
-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.
- *
- * @typedef {function(this:Object, string, *): *}
- */
-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, *): *}
- */
-goog.json.Reviver;
-
-
-/**
- * Serializes an object or a value to a JSON string.
- *
- * @param {*} object The object to serialize.
- * @param {?goog.json.Replacer=} opt_replacer 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.
- * @throws Error if there are loops in the object graph.
- * @return {string} A JSON string representation of the input.
- */
-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);
-    };
-
-
-
-/**
- * Class that is used to serialize JSON objects to a string.
- * @param {?goog.json.Replacer=} opt_replacer Replacer.
- * @constructor
- */
-goog.json.Serializer = function(opt_replacer) {
-  /**
-   * @type {goog.json.Replacer|null|undefined}
-   * @private
-   */
-  this.replacer_ = opt_replacer;
-};
-
-
-/**
- * Serializes an object or a value to a JSON string.
- *
- * @param {*} object The object to serialize.
- * @throws Error if there are loops in the object graph.
- * @return {string} A JSON string representation of the input.
- */
-goog.json.Serializer.prototype.serialize = function(object) {
-  var sb = [];
-  this.serializeInternal(object, sb);
-  return sb.join('');
-};
-
-
-/**
- * Serializes a generic value to a JSON string
- * @protected
- * @param {*} object The object to serialize.
- * @param {Array<string>} sb Array used as a string builder.
- * @throws Error if there are loops in the object graph.
- */
-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_(object, sb);
-      break;
-    case 'number':
-      this.serializeNumber_(object, sb);
-      break;
-    case 'boolean':
-      sb.push(String(object));
-      break;
-    case 'function':
-      sb.push('null');
-      break;
-    default:
-      throw Error('Unknown type: ' + typeof object);
-  }
-};
-
-
-/**
- * Character mappings used internally for goog.string.quote
- * @private
- * @type {!Object}
- */
-goog.json.Serializer.charToJsonCharCache_ = {
-  '\"': '\\"',
-  '\\': '\\\\',
-  '/': '\\/',
-  '\b': '\\b',
-  '\f': '\\f',
-  '\n': '\\n',
-  '\r': '\\r',
-  '\t': '\\t',
-
-  '\x0B': '\\u000b' // '\v' is not supported in JScript
-};
-
-
-/**
- * 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.
- * @private
- * @type {!RegExp}
- */
-goog.json.Serializer.charsToReplace_ = /\uffff/.test('\uffff') ?
-    /[\\\"\x00-\x1f\x7f-\uffff]/g : /[\\\"\x00-\x1f\x7f-\xff]/g;
-
-
-/**
- * Serializes a string to a JSON string
- * @private
- * @param {string} s The string to serialize.
- * @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
-    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 rv;
-  }), '"');
-};
-
-
-/**
- * Serializes a number to a JSON string
- * @private
- * @param {number} n The number to serialize.
- * @param {Array<string>} sb Array used as a string builder.
- */
-goog.json.Serializer.prototype.serializeNumber_ = function(n, sb) {
-  sb.push(isFinite(n) && !isNaN(n) ? String(n) : 'null');
-};
-
-
-/**
- * Serializes an array to a JSON string
- * @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) {
-  var l = arr.length;
-  sb.push('[');
-  var sep = '';
-  for (var i = 0; i < l; i++) {
-    sb.push(sep);
-
-    var value = arr[i];
-    this.serializeInternal(
-        this.replacer_ ? this.replacer_.call(arr, String(i), value) : value,
-        sb);
-
-    sep = ',';
-  }
-  sb.push(']');
-};
-
-
-/**
- * Serializes an object to a JSON string
- * @private
- * @param {Object} obj The object to serialize.
- * @param {Array<string>} sb Array used as a string builder.
- */
-goog.json.Serializer.prototype.serializeObject_ = function(obj, sb) {
-  sb.push('{');
-  var sep = '';
-  for (var key in obj) {
-    if (Object.prototype.hasOwnProperty.call(obj, key)) {
-      var value = obj[key];
-      // Skip functions.
-      if (typeof value != 'function') {
-        sb.push(sep);
-        this.serializeString_(key, sb);
-        sb.push(':');
-
-        this.serializeInternal(
-            this.replacer_ ? this.replacer_.call(obj, key, value) : value,
-            sb);
-
-        sep = ',';
-      }
-    }
-  }
-  sb.push('}');
-};

package/lib/goog/labs/testing/assertthat.js

@@ -1,58 +0,0 @@
-// 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 Provides main functionality of assertThat. assertThat calls the
- * matcher's matches method to test if a matcher matches assertThat's arguments.
- */
-
-
-goog.provide('goog.labs.testing.MatcherError');
-goog.provide('goog.labs.testing.assertThat');
-
-goog.require('goog.debug.Error');
-
-
-/**
- * Asserts that the actual value evaluated by the matcher is true.
- *
- * @param {*} actual The object to assert by the matcher.
- * @param {!goog.labs.testing.Matcher} matcher A matcher to verify values.
- * @param {string=} opt_reason Description of what is asserted.
- *
- */
-goog.labs.testing.assertThat = function(actual, matcher, opt_reason) {
-  if (!matcher.matches(actual)) {
-    // Prefix the error description with a reason from the assert ?
-    var prefix = opt_reason ? opt_reason + ': ' : '';
-    var desc = prefix + matcher.describe(actual);
-
-    // some sort of failure here
-    throw new goog.labs.testing.MatcherError(desc);
-  }
-};
-
-
-
-/**
- * Error thrown when a Matcher fails to match the input value.
- * @param {string=} opt_message The error message.
- * @constructor
- * @extends {goog.debug.Error}
- * @final
- */
-goog.labs.testing.MatcherError = function(opt_message) {
-  goog.labs.testing.MatcherError.base(this, 'constructor', opt_message);
-};
-goog.inherits(goog.labs.testing.MatcherError, goog.debug.Error);

package/lib/goog/labs/testing/logicmatcher.js

@@ -1,212 +0,0 @@
-// 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 Provides the built-in logic matchers: anyOf, allOf, and isNot.
- *
- */
-
-
-goog.provide('goog.labs.testing.AllOfMatcher');
-goog.provide('goog.labs.testing.AnyOfMatcher');
-goog.provide('goog.labs.testing.IsNotMatcher');
-
-
-goog.require('goog.array');
-goog.require('goog.labs.testing.Matcher');
-
-
-
-/**
- * The AllOf matcher.
- *
- * @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>}
-   * @private
-   */
-  this.matchers_ = matchers;
-};
-
-
-/**
- * Determines if all of the matchers match the input value.
- *
- * @override
- */
-goog.labs.testing.AllOfMatcher.prototype.matches = function(actualValue) {
-  return goog.array.every(this.matchers_, function(matcher) {
-    return matcher.matches(actualValue);
-  });
-};
-
-
-/**
- * Describes why the matcher failed. The returned string is a concatenation of
- * all the failed matchers' error strings.
- *
- * @override
- */
-goog.labs.testing.AllOfMatcher.prototype.describe =
-    function(actualValue) {
-  // TODO(user) : Optimize this to remove duplication with matches ?
-  var errorString = '';
-  goog.array.forEach(this.matchers_, function(matcher) {
-    if (!matcher.matches(actualValue)) {
-      errorString += matcher.describe(actualValue) + '\n';
-    }
-  });
-  return errorString;
-};
-
-
-
-/**
- * The AnyOf matcher.
- *
- * @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>}
-   * @private
-   */
-  this.matchers_ = matchers;
-};
-
-
-/**
- * Determines if any of the matchers matches the input value.
- *
- * @override
- */
-goog.labs.testing.AnyOfMatcher.prototype.matches = function(actualValue) {
-  return goog.array.some(this.matchers_, function(matcher) {
-    return matcher.matches(actualValue);
-  });
-};
-
-
-/**
- * Describes why the matcher failed.
- *
- * @override
- */
-goog.labs.testing.AnyOfMatcher.prototype.describe =
-    function(actualValue) {
-  // TODO(user) : Optimize this to remove duplication with matches ?
-  var errorString = '';
-  goog.array.forEach(this.matchers_, function(matcher) {
-    if (!matcher.matches(actualValue)) {
-      errorString += matcher.describe(actualValue) + '\n';
-    }
-  });
-  return errorString;
-};
-
-
-
-/**
- * The IsNot matcher.
- *
- * @param {!goog.labs.testing.Matcher} matcher The matcher to negate.
- *
- * @constructor
- * @struct
- * @implements {goog.labs.testing.Matcher}
- * @final
- */
-goog.labs.testing.IsNotMatcher = function(matcher) {
-  /**
-   * @type {!goog.labs.testing.Matcher}
-   * @private
-   */
-  this.matcher_ = matcher;
-};
-
-
-/**
- * Determines if the input value doesn't satisfy a matcher.
- *
- * @override
- */
-goog.labs.testing.IsNotMatcher.prototype.matches = function(actualValue) {
-  return !this.matcher_.matches(actualValue);
-};
-
-
-/**
- * Describes why the matcher failed.
- *
- * @override
- */
-goog.labs.testing.IsNotMatcher.prototype.describe =
-    function(actualValue) {
-  return 'The following is false: ' + this.matcher_.describe(actualValue);
-};
-
-
-/**
- * Creates a matcher that will succeed only if all of the given matchers
- * succeed.
- *
- * @param {...goog.labs.testing.Matcher} var_args The matchers to test
- *     against.
- *
- * @return {!goog.labs.testing.AllOfMatcher} The AllOf matcher.
- */
-function allOf(var_args) {
-  var matchers = goog.array.toArray(arguments);
-  return new goog.labs.testing.AllOfMatcher(matchers);
-}
-
-
-/**
- * Accepts a set of matchers and returns a matcher which matches
- * values which satisfy the constraints of any of the given matchers.
- *
- * @param {...goog.labs.testing.Matcher} var_args The matchers to test
- *     against.
- *
- * @return {!goog.labs.testing.AnyOfMatcher} The AnyOf matcher.
- */
-function anyOf(var_args) {
-  var matchers = goog.array.toArray(arguments);
-  return new goog.labs.testing.AnyOfMatcher(matchers);
-}
-
-
-/**
- * Returns a matcher that negates the input matcher. The returned
- * matcher matches the values not matched by the input matcher and vice-versa.
- *
- * @param {!goog.labs.testing.Matcher} matcher The matcher to test against.
- *
- * @return {!goog.labs.testing.IsNotMatcher} The IsNot matcher.
- */
-function isNot(matcher) {
-  return new goog.labs.testing.IsNotMatcher(matcher);
-}

package/lib/goog/labs/testing/matcher.js

@@ -1,80 +0,0 @@
-// 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 Provides the base Matcher interface. User code should use the
- * matchers through assertThat statements and not directly.
- */
-
-
-goog.provide('goog.labs.testing.Matcher');
-
-
-
-/**
- * A matcher object to be used in assertThat statements.
- * @interface
- */
-goog.labs.testing.Matcher = function() {};
-
-
-/**
- * Determines whether a value matches the constraints of the match.
- *
- * @param {*} value The object to match.
- * @return {boolean} Whether the input value matches this matcher.
- */
-goog.labs.testing.Matcher.prototype.matches = function(value) {};
-
-
-/**
- * Describes why the matcher failed.
- *
- * @param {*} value The value that didn't match.
- * @param {string=} opt_description A partial description to which the reason
- *     will be appended.
- *
- * @return {string} Description of why the matcher failed.
- */
-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;
-};