selenium-webdriver 3.5.0 → 4.0.0-alpha.4

package/test/window_test.js

@@ -1,161 +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.
-
-'use strict';
-
-var Browser = require('..').Browser,
-    By = require('..').By,
-    assert = require('../testing/assert'),
-    test = require('../lib/test');
-
-
-test.suite(function(env) {
-  var driver;
-
-  test.before(function*() { driver = yield env.builder().build(); });
-  test.after(function() { return driver.quit(); });
-
-  test.beforeEach(function() {
-    return driver.switchTo().defaultContent();
-  });
-
-  test.it('can set size of the current window', function*() {
-    yield driver.get(test.Pages.echoPage);
-    yield changeSizeBy(-20, -20);
-  });
-
-  test.it('can set size of the current window from frame', function*() {
-    yield driver.get(test.Pages.framesetPage);
-
-    var frame = yield driver.findElement({css: 'frame[name="fourth"]'});
-    yield driver.switchTo().frame(frame);
-    yield changeSizeBy(-20, -20);
-  });
-
-  test.it('can set size of the current window from iframe', function*() {
-    yield driver.get(test.Pages.iframePage);
-
-    var frame = yield driver.findElement({css: 'iframe[name="iframe1-name"]'});
-    yield driver.switchTo().frame(frame);
-    yield changeSizeBy(-20, -20);
-  });
-
-  test.it('can switch to a new window', function*() {
-    yield driver.get(test.Pages.xhtmlTestPage);
-
-    let handle = yield driver.getWindowHandle();
-    let originalHandles = yield driver.getAllWindowHandles();
-
-    yield driver.findElement(By.linkText("Open new window")).click();
-    yield driver.wait(forNewWindowToBeOpened(originalHandles), 2000);
-    yield assert(driver.getTitle()).equalTo("XHTML Test Page");
-
-    let newHandle = yield getNewWindowHandle(originalHandles);
-
-    yield driver.switchTo().window(newHandle);
-    yield assert(driver.getTitle()).equalTo("We Arrive Here");
-  });
-
-  test.it('can set the window position of the current window', function*() {
-    let position = yield driver.manage().window().getPosition();
-
-    yield driver.manage().window().setSize(640, 480);
-    yield 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.currentBrowser() === Browser.PHANTOM_JS) {
-      position = yield driver.manage().window().getPosition();
-      assert(position.x).equalTo(0);
-      assert(position.y).equalTo(0);
-    } else {
-      var dx = position.x + 10;
-      var dy = position.y + 10;
-      return driver.wait(forPositionToBe(dx, dy), 1000);
-    }
-  });
-
-  test.it('can set the window position from a frame', function*() {
-    yield driver.get(test.Pages.iframePage);
-
-    let frame = yield driver.findElement(By.name('iframe1-name'));
-    yield driver.switchTo().frame(frame);
-
-    let position = yield driver.manage().window().getPosition();
-    yield driver.manage().window().setSize(640, 480);
-    yield 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.currentBrowser() === Browser.PHANTOM_JS) {
-      return driver.manage().window().getPosition().then(function(position) {
-        assert(position.x).equalTo(0);
-        assert(position.y).equalTo(0);
-      });
-    } else {
-      var dx = position.x + 10;
-      var dy = position.y + 10;
-      return driver.wait(forPositionToBe(dx, dy), 1000);
-    }
-  });
-
-  function changeSizeBy(dx, dy) {
-    return driver.manage().window().getSize().then(function(size) {
-      return driver.manage().window()
-          .setSize(size.width + dx, size.height + dy)
-          .then(_ => {
-            return driver.wait(
-                forSizeToBe(size.width + dx, size.height + dy), 1000);
-          });
-    });
-  }
-
-  function forSizeToBe(w, h) {
-    return function() {
-      return driver.manage().window().getSize().then(function(size) {
-        return size.width === w && size.height === h;
-      });
-    };
-  }
-
-  function forPositionToBe(x, y) {
-    return function() {
-      return driver.manage().window().getPosition().then(function(position) {
-        return position.x === x &&
-            // On OSX, the window height may be bumped down 22px for the top
-            // status bar.
-            // On Linux, Opera's window position will be off by 28px.
-           (position.y >= y && position.y <= (y + 28));
-      });
-    };
-  }
-
-  function forNewWindowToBeOpened(originalHandles) {
-    return function() {
-      return driver.getAllWindowHandles().then(function(currentHandles) {
-        return currentHandles.length > originalHandles.length;
-      });
-    };
-  }
-
-  function getNewWindowHandle(originalHandles) {
-    // Note: this assumes there's just one new window.
-    return driver.getAllWindowHandles().then(function(currentHandles) {
-      return currentHandles.filter(function(i) {
-        return originalHandles.indexOf(i) < 0;
-      })[0];
-    });
-  }
-});

package/testing/assert.js

@@ -1,378 +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.
-
-/**
- * @fileoverview Defines a library that simplifies writing assertions against
- * promised values.
- *
- * > <hr>
- * > __NOTE:__ This module is considered experimental and is subject to
- * > change, or removal, at any time!
- * > <hr>
- *
- * Sample usage:
- *
- *     var driver = new webdriver.Builder().build();
- *     driver.get('http://www.google.com');
- *
- *     assert(driver.getTitle()).equalTo('Google');
- */
-
-'use strict';
-
-const assert = require('assert');
-
-function trueType(v) {
-  if (v === null) {
-    return 'null';
-  }
-
-  let type = typeof v;
-  if (type === 'object') {
-    if (Array.isArray(v)) {
-      type = 'array';
-    }
-  }
-  return type;
-}
-
-
-function checkType(v, want) {
-  let got = trueType(v);
-  if (got !== want) {
-    throw new TypeError('require ' + want + ', but got ' + got);
-  }
-  return v;
-}
-
-const checkNumber = v => checkType(v, 'number');
-const checkFunction = v => checkType(v, 'function');
-const checkString = v => checkType(v, 'string');
-
-const isFunction = v => trueType(v) === 'function';
-const isNumber = v => trueType(v) === 'number';
-const isObject = v => trueType(v) === 'object';
-const isString = v => trueType(v) === 'string';
-
-
-function describe(value) {
-  let ret;
-  try {
-    ret = `<${String(value)}>`;
-  } catch (e) {
-    ret = `<toString failed: ${e.message}>`;
-  }
-
-  if (null !== value && void(0) !== value) {
-    ret += ` (${trueType(value)})`;
-  }
-
-  return ret;
-}
-
-
-function evaluate(value, predicate) {
-  if (isObject(value) && isFunction(value.then)) {
-    return value.then(predicate);
-  }
-  predicate(value);
-}
-
-
-/**
- * @private
- */
-class Assertion {
-  /**
-   * @param {?} subject The subject of this assertion.
-   * @param {boolean=} opt_invert Whether to invert any assertions performed by
-   *     this instance.
-   */
-  constructor(subject, opt_invert) {
-    /** @private {?} */
-    this.subject_ = subject;
-    /** @private {boolean} */
-    this.invert_ = !!opt_invert;
-  }
-
-  /**
-   * @param {number} expected The minimum permissible value (inclusive).
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  atLeast(expected, opt_message) {
-    checkNumber(expected);
-    return evaluate(this.subject_, function(actual) {
-      if (!isNumber(actual) || actual < expected) {
-        assert.fail(actual, expected, opt_message, '>=');
-      }
-    });
-  }
-
-  /**
-   * @param {number} expected The maximum permissible value (inclusive).
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  atMost(expected, opt_message) {
-    checkNumber(expected);
-    return evaluate(this.subject_, function (actual) {
-      if (!isNumber(actual) || actual > expected) {
-        assert.fail(actual, expected, opt_message, '<=');
-      }
-    });
-  }
-
-  /**
-   * @param {number} expected The maximum permissible value (exclusive).
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  greaterThan(expected, opt_message) {
-    checkNumber(expected);
-    return evaluate(this.subject_, function(actual) {
-      if (!isNumber(actual) || actual <= expected) {
-        assert.fail(actual, expected, opt_message, '>');
-      }
-    });
-  }
-
-  /**
-   * @param {number} expected The minimum permissible value (exclusive).
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  lessThan(expected, opt_message) {
-    checkNumber(expected);
-    return evaluate(this.subject_,  function (actual) {
-      if (!isNumber(actual) || actual >= expected) {
-        assert.fail(actual, expected, opt_message, '<');
-      }
-    });
-  }
-
-  /**
-   * @param {number} expected The desired value.
-   * @param {number} epsilon The maximum distance from the desired value.
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  closeTo(expected, epsilon, opt_message) {
-    checkNumber(expected);
-    checkNumber(epsilon);
-    return evaluate(this.subject_, function(actual) {
-      checkNumber(actual);
-      if (Math.abs(expected - actual) > epsilon) {
-        assert.fail(opt_message || `${actual} === ${expected} (± ${epsilon})`);
-      }
-    });
-  }
-
-  /**
-   * @param {function(new: ?)} ctor The exptected type's constructor.
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  instanceOf(ctor, opt_message) {
-    checkFunction(ctor);
-    return evaluate(this.subject_, function(actual) {
-      if (!(actual instanceof ctor)) {
-        assert.fail(
-            opt_message
-                || `${describe(actual)} instanceof ${ctor.name || ctor}`);
-      }
-    });
-  }
-
-  /**
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  isNull(opt_message) {
-    return this.isEqualTo(null);
-  }
-
-  /**
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  isUndefined(opt_message) {
-    return this.isEqualTo(void(0));
-  }
-
-  /**
-   * Ensures the subject of this assertion is either a string or array
-   * containing the given `value`.
-   *
-   * @param {?} value The value expected to be contained within the subject.
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  contains(value, opt_message) {
-    return evaluate(this.subject_, function(actual) {
-      if (actual instanceof Map || actual instanceof Set) {
-        assert.ok(actual.has(value), opt_message || `${actual}.has(${value})`);
-      } else if (Array.isArray(actual) || isString(actual)) {
-        assert.ok(
-            actual.indexOf(value) !== -1,
-            opt_message || `${actual}.indexOf(${value}) !== -1`);
-      } else {
-        assert.fail(
-            `Expected an array, map, set, or string: got ${describe(actual)}`);
-      }
-    });
-  }
-
-  /**
-   * @param {string} str The expected suffix.
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  endsWith(str, opt_message) {
-    checkString(str);
-    return evaluate(this.subject_, function(actual) {
-      if (!isString(actual) || !actual.endsWith(str)) {
-        assert.fail(actual, str, 'ends with');
-      }
-    });
-  }
-
-  /**
-   * @param {string} str The expected prefix.
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  startsWith(str, opt_message) {
-    checkString(str);
-    return evaluate(this.subject_, function(actual) {
-      if (!isString(actual) || !actual.startsWith(str)) {
-        assert.fail(actual, str, 'starts with');
-      }
-    });
-  }
-
-  /**
-   * @param {!RegExp} regex The regex the subject is expected to match.
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  matches(regex, opt_message) {
-    if (!(regex instanceof RegExp)) {
-      throw TypeError(`Not a RegExp: ${describe(regex)}`);
-    }
-    return evaluate(this.subject_, function(actual) {
-      if (!isString(actual) || !regex.test(actual)) {
-        let message = opt_message
-            || `Expected a string matching ${regex}, got ${describe(actual)}`;
-        assert.fail(actual, regex, message);
-      }
-    });
-  }
-
-  /**
-   * @param {?} value The unexpected value.
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  notEqualTo(value, opt_message) {
-    return evaluate(this.subject_, function(actual) {
-      assert.notStrictEqual(actual, value, opt_message);
-    });
-  }
-
-  /** An alias for {@link #isEqualTo}. */
-  equalTo(value, opt_message) {
-    return this.isEqualTo(value, opt_message);
-  }
-
-  /** An alias for {@link #isEqualTo}. */
-  equals(value, opt_message) {
-    return this.isEqualTo(value, opt_message);
-  }
-
-  /**
-   * @param {?} value The expected value.
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  isEqualTo(value, opt_message) {
-    return evaluate(this.subject_, function(actual) {
-      assert.strictEqual(actual, value, opt_message);
-    });
-  }
-
-  /**
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  isTrue(opt_message) {
-    return this.isEqualTo(true, opt_message);
-  }
-
-  /**
-   * @param {string=} opt_message An optional failure message.
-   * @return {(Promise|undefined)} The result of this assertion, if the subject
-   *     is a promised-value. Otherwise, the assertion is performed immediately
-   *     and nothing is returned.
-   */
-  isFalse(opt_message) {
-    return this.isEqualTo(false, opt_message);
-  }
-}
-
-
-// PUBLIC API
-
-
-/**
- * Creates an assertion about the given `value`.
- * @return {!Assertion} the new assertion.
- */
-module.exports = function assertThat(value) {
-  return new Assertion(value);
-};
-module.exports.Assertion = Assertion;  // Exported to help generated docs