selenium-webdriver 2.47.0 → 2.52.0

package/lib/goog/testing/objectpropertystring.js

@@ -1,68 +0,0 @@
-// 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_;
-};

package/lib/goog/testing/propertyreplacer.js

@@ -1,245 +0,0 @@
-// 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:
- * <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>
- *
- * @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>}
-   * @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.
- * @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] = '';
-  }
-};
-
-
-/**
- * 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.
- */
-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;
-};
-
-
-/**
- * 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;
-};

package/lib/goog/testing/recordfunction.js

@@ -1,215 +0,0 @@
-// 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_;
-};