selenium-webdriver 2.48.2 → 2.52.0

package/lib/webdriver/test/testing/client_test.js

@@ -1,88 +0,0 @@
-// 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();
-}

package/lib/webdriver/test/testing/testcase_test.js

@@ -1,229 +0,0 @@
-// 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();
-}

package/lib/webdriver/test/testutil.js

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

package/lib/webdriver/test/testutil_test.js

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