selenium-webdriver 3.5.0 → 4.0.0-alpha.4

package/test/lib/by_test.js

@@ -1,160 +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 assert = require('assert');
-var by = require('../../lib/by');
-
-describe('by', function() {
-  describe('By', function() {
-    describe('className', function() {
-      it('delegates to By.css', function() {
-        let locator = by.By.className('foo');
-        assert.equal('css selector', locator.using);
-        assert.equal('.foo', locator.value);
-      });
-
-      it('escapes class name', function() {
-        let locator = by.By.className('foo#bar');
-        assert.equal('css selector', locator.using);
-        assert.equal('.foo\\#bar', locator.value);
-      });
-
-      it('translates compound class names', function() {
-        let locator = by.By.className('a b');
-        assert.equal('css selector', locator.using);
-        assert.equal('.a.b', locator.value);
-
-        locator = by.By.className('  x   y   z-1  "g" ');
-        assert.equal('css selector', locator.using);
-        assert.equal('.x.y.z-1.\\"g\\"', locator.value);
-      });
-    });
-
-    describe('id', function() {
-      it('delegates to By.css', function() {
-        let locator = by.By.id('foo');
-        assert.equal('css selector', locator.using);
-        assert.equal('*[id="foo"]', locator.value);
-      });
-
-      it('escapes the ID', function() {
-        let locator = by.By.id('foo#bar');
-        assert.equal('css selector', locator.using);
-        assert.equal('*[id="foo\\#bar"]', locator.value);
-      });
-    });
-
-    describe('name', function() {
-      it('delegates to By.css', function() {
-        let locator = by.By.name('foo')
-        assert.equal('css selector', locator.using);
-        assert.equal('*[name="foo"]', locator.value);
-      });
-
-      it('escapes the name', function() {
-        let locator = by.By.name('foo"bar"')
-        assert.equal('css selector', locator.using);
-        assert.equal('*[name="foo\\"bar\\""]', locator.value);
-      });
-
-      it('escapes the name when it starts with a number', function() {
-        let locator = by.By.name('123foo"bar"')
-        assert.equal('css selector', locator.using);
-        assert.equal('*[name="\\31 23foo\\"bar\\""]', locator.value);
-      });
-
-      it('escapes the name when it starts with a negative number', function() {
-        let locator = by.By.name('-123foo"bar"')
-        assert.equal('css selector', locator.using);
-        assert.equal('*[name="-\\31 23foo\\"bar\\""]', locator.value);
-      });
-    });
-  });
-
-  describe('checkedLocator', function() {
-    it('accepts a By instance', function() {
-      let original = by.By.name('foo');
-      let locator = by.checkedLocator(original);
-      assert.strictEqual(locator, original);
-    });
-
-    it('accepts custom locator functions', function() {
-      let original = function() {};
-      let locator = by.checkedLocator(original);
-      assert.strictEqual(locator, original);
-    });
-
-    // See https://github.com/SeleniumHQ/selenium/issues/3056
-    it('accepts By-like objects', function() {
-      let fakeBy = {using: 'id', value: 'foo'};
-      let locator = by.checkedLocator(fakeBy);
-      assert.strictEqual(locator.constructor, by.By);
-      assert.equal(locator.using, 'id');
-      assert.equal(locator.value, 'foo');
-    });
-
-    it('accepts class name', function() {
-      let locator = by.checkedLocator({className: 'foo'});
-      assert.equal('css selector', locator.using);
-      assert.equal('.foo', locator.value);
-    });
-
-    it('accepts css', function() {
-      let locator = by.checkedLocator({css: 'a > b'});
-      assert.equal('css selector', locator.using);
-      assert.equal('a > b', locator.value);
-    });
-
-    it('accepts id', function() {
-      let locator = by.checkedLocator({id: 'foobar'});
-      assert.equal('css selector', locator.using);
-      assert.equal('*[id="foobar"]', locator.value);
-    });
-
-    it('accepts linkText', function() {
-      let locator = by.checkedLocator({linkText: 'hello'});
-      assert.equal('link text', locator.using);
-      assert.equal('hello', locator.value);
-    });
-
-    it('accepts name', function() {
-      let locator = by.checkedLocator({name: 'foobar'});
-      assert.equal('css selector', locator.using);
-      assert.equal('*[name="foobar"]', locator.value);
-    });
-
-    it('accepts partialLinkText', function() {
-      let locator = by.checkedLocator({partialLinkText: 'hello'});
-      assert.equal('partial link text', locator.using);
-      assert.equal('hello', locator.value);
-    });
-
-    it('accepts tagName', function() {
-      let locator = by.checkedLocator({tagName: 'div'});
-      assert.equal('css selector', locator.using);
-      assert.equal('div', locator.value);
-    });
-
-    it('accepts xpath', function() {
-      let locator = by.checkedLocator({xpath: '//div[1]'});
-      assert.equal('xpath', locator.using);
-      assert.equal('//div[1]', locator.value);
-    });
-  });
-});

package/test/lib/capabilities_test.js

@@ -1,111 +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';
-
-const Capabilities = require('../../lib/capabilities').Capabilities;
-const Symbols = require('../../lib/symbols');
-
-const assert = require('assert');
-
-describe('Capabilities', function() {
-  it('can set and unset a capability', function() {
-    let caps = new Capabilities();
-    assert.equal(undefined, caps.get('foo'));
-    assert.ok(!caps.has('foo'));
-
-    caps.set('foo', 'bar');
-    assert.equal('bar', caps.get('foo'));
-    assert.ok(caps.has('foo'));
-
-    caps.set('foo', null);
-    assert.equal(null, caps.get('foo'));
-    assert.ok(caps.has('foo'));
-  });
-
-  it('requires string capability keys', function() {
-    let caps = new Capabilities();
-    assert.throws(() => caps.set({}, 'hi'));
-  });
-
-  it('can merge capabilities', function() {
-    let caps1 = new Capabilities()
-        .set('foo', 'bar')
-        .set('color', 'red');
-
-    let caps2 = new Capabilities()
-        .set('color', 'green');
-
-    assert.equal('bar', caps1.get('foo'));
-    assert.equal('red', caps1.get('color'));
-    assert.equal('green', caps2.get('color'));
-    assert.equal(undefined, caps2.get('foo'));
-
-    caps2.merge(caps1);
-    assert.equal('bar', caps1.get('foo'));
-    assert.equal('red', caps1.get('color'));
-    assert.equal('red', caps2.get('color'));
-    assert.equal('bar', caps2.get('foo'));
-  });
-
-  it('can be initialized from a hash object', function() {
-    let caps = new Capabilities({'one': 123, 'abc': 'def'});
-    assert.equal(123, caps.get('one'));
-    assert.equal('def', caps.get('abc'));
-  });
-
-  it('can be initialized from a map', function() {
-    let m = new Map([['one', 123], ['abc', 'def']]);
-
-    let caps = new Capabilities(m);
-    assert.equal(123, caps.get('one'));
-    assert.equal('def', caps.get('abc'));
-  });
-
-  describe('serialize', function() {
-    it('works for simple capabilities', function() {
-      let m = new Map([['one', 123], ['abc', 'def']]);
-      let caps = new Capabilities(m);
-      assert.deepEqual({one: 123, abc: 'def'}, caps[Symbols.serialize]());
-    });
-
-    it('does not omit capabilities set to a false-like value', function() {
-      let caps = new Capabilities;
-      caps.set('bool', false);
-      caps.set('number', 0);
-      caps.set('string', '');
-
-      assert.deepEqual(
-          {bool: false, number: 0, string: ''},
-          caps[Symbols.serialize]());
-    });
-
-    it('omits capabilities with a null value', function() {
-      let caps = new Capabilities;
-      caps.set('foo', null);
-      caps.set('bar', 123);
-      assert.deepEqual({bar: 123}, caps[Symbols.serialize]());
-    });
-
-    it('omits capabilities with an undefined value', function() {
-      let caps = new Capabilities;
-      caps.set('foo', undefined);
-      caps.set('bar', 123);
-      assert.deepEqual({bar: 123}, caps[Symbols.serialize]());
-    });
-  });
-});

package/test/lib/error_test.js

@@ -1,305 +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';
-
-describe('error', function() {
-  let assert = require('assert');
-  let error = require('../../lib/error');
-
-  describe('checkResponse', function() {
-    it('defaults to WebDriverError if type is unrecognized', function() {
-      assert.throws(
-          () => error.checkResponse({error: 'foo', message: 'hi there'}),
-          (e) => {
-            assert.equal(e.constructor, error.WebDriverError);
-            return true;
-          });
-    });
-
-    it('does not throw if error property is not a string', function() {
-      let resp = {error: 123, message: 'abc123'};
-      let out = error.checkResponse(resp);
-      assert.strictEqual(out, resp);
-    });
-
-    test('unknown error', error.WebDriverError);
-    test('element not selectable', error.ElementNotSelectableError);
-    test('element not visible', error.ElementNotVisibleError);
-    test('invalid argument', error.InvalidArgumentError);
-    test('invalid cookie domain', error.InvalidCookieDomainError);
-    test('invalid element coordinates', error.InvalidElementCoordinatesError);
-    test('invalid element state', error.InvalidElementStateError);
-    test('invalid selector', error.InvalidSelectorError);
-    test('invalid session id', error.NoSuchSessionError);
-    test('javascript error', error.JavascriptError);
-    test('move target out of bounds', error.MoveTargetOutOfBoundsError);
-    test('no such alert', error.NoSuchAlertError);
-    test('no such element', error.NoSuchElementError);
-    test('no such frame', error.NoSuchFrameError);
-    test('no such window', error.NoSuchWindowError);
-    test('script timeout', error.ScriptTimeoutError);
-    test('session not created', error.SessionNotCreatedError);
-    test('stale element reference', error.StaleElementReferenceError);
-    test('timeout', error.TimeoutError);
-    test('unable to set cookie', error.UnableToSetCookieError);
-    test('unable to capture screen', error.UnableToCaptureScreenError);
-    test('unexpected alert open', error.UnexpectedAlertOpenError);
-    test('unknown command', error.UnknownCommandError);
-    test('unknown method', error.UnknownMethodError);
-    test('unsupported operation', error.UnsupportedOperationError);
-
-    function test(status, expectedType) {
-      it(`"${status}" => ${expectedType.name}`, function() {
-        assert.throws(
-            () => error.checkResponse({error: status, message: 'oops'}),
-            (e) => {
-              assert.equal(expectedType, e.constructor);
-              assert.equal(e.message, 'oops');
-              return true;
-            });
-      });
-    }
-  });
-
-  describe('encodeError', function() {
-    describe('defaults to an unknown error', function() {
-      it('for a generic error value', function() {
-        runTest('hi', 'unknown error', 'hi');
-        runTest(1, 'unknown error', '1');
-        runTest({}, 'unknown error', '[object Object]');
-      });
-
-      it('for a generic Error object', function() {
-        runTest(Error('oops'), 'unknown error', 'oops');
-        runTest(TypeError('bad value'), 'unknown error', 'bad value');
-      });
-    });
-
-    test(error.WebDriverError, 'unknown error');
-    test(error.ElementNotSelectableError, 'element not selectable');
-    test(error.ElementNotVisibleError, 'element not visible');
-    test(error.InvalidArgumentError, 'invalid argument');
-    test(error.InvalidCookieDomainError, 'invalid cookie domain');
-    test(error.InvalidElementStateError, 'invalid element state');
-    test(error.InvalidSelectorError, 'invalid selector');
-    test(error.NoSuchSessionError, 'invalid session id');
-    test(error.JavascriptError, 'javascript error');
-    test(error.MoveTargetOutOfBoundsError, 'move target out of bounds');
-    test(error.NoSuchAlertError, 'no such alert');
-    test(error.NoSuchElementError, 'no such element');
-    test(error.NoSuchFrameError, 'no such frame');
-    test(error.NoSuchWindowError, 'no such window');
-    test(error.ScriptTimeoutError, 'script timeout');
-    test(error.SessionNotCreatedError, 'session not created');
-    test(error.StaleElementReferenceError, 'stale element reference');
-    test(error.TimeoutError, 'timeout');
-    test(error.UnableToSetCookieError, 'unable to set cookie');
-    test(error.UnableToCaptureScreenError, 'unable to capture screen');
-    test(error.UnexpectedAlertOpenError, 'unexpected alert open');
-    test(error.UnknownCommandError, 'unknown command');
-    test(error.UnknownMethodError, 'unknown method');
-    test(error.UnsupportedOperationError, 'unsupported operation');
-
-    function test(ctor, code) {
-      it(`${ctor.name} => "${code}"`, () => {
-        runTest(new ctor('oops'), code, 'oops');
-      });
-    }
-
-    function runTest(err, code, message) {
-      let obj = error.encodeError(err);
-      assert.strictEqual(obj['error'], code);
-      assert.strictEqual(obj['message'], message);
-    }
-  });
-
-  describe('throwDecodedError', function() {
-    it('defaults to WebDriverError if type is unrecognized', function() {
-      assert.throws(
-          () => error.throwDecodedError({error: 'foo', message: 'hi there'}),
-          (e) => {
-            assert.equal(e.constructor, error.WebDriverError);
-            return true;
-          });
-    });
-
-    it('throws generic error if encoded data is not valid', function() {
-      assert.throws(
-          () => error.throwDecodedError({error: 123, message: 'abc123'}),
-          (e) => {
-            assert.strictEqual(e.constructor, error.WebDriverError);
-            return true;
-          });
-
-      assert.throws(
-          () => error.throwDecodedError('null'),
-          (e) => {
-            assert.strictEqual(e.constructor, error.WebDriverError);
-            return true;
-          });
-
-      assert.throws(
-          () => error.throwDecodedError(''),
-          (e) => {
-            assert.strictEqual(e.constructor, error.WebDriverError);
-            return true;
-          });
-    });
-
-    test('unknown error', error.WebDriverError);
-    test('element not selectable', error.ElementNotSelectableError);
-    test('element not visible', error.ElementNotVisibleError);
-    test('invalid argument', error.InvalidArgumentError);
-    test('invalid cookie domain', error.InvalidCookieDomainError);
-    test('invalid element coordinates', error.InvalidElementCoordinatesError);
-    test('invalid element state', error.InvalidElementStateError);
-    test('invalid selector', error.InvalidSelectorError);
-    test('invalid session id', error.NoSuchSessionError);
-    test('javascript error', error.JavascriptError);
-    test('move target out of bounds', error.MoveTargetOutOfBoundsError);
-    test('no such alert', error.NoSuchAlertError);
-    test('no such element', error.NoSuchElementError);
-    test('no such frame', error.NoSuchFrameError);
-    test('no such window', error.NoSuchWindowError);
-    test('script timeout', error.ScriptTimeoutError);
-    test('session not created', error.SessionNotCreatedError);
-    test('stale element reference', error.StaleElementReferenceError);
-    test('timeout', error.TimeoutError);
-    test('unable to set cookie', error.UnableToSetCookieError);
-    test('unable to capture screen', error.UnableToCaptureScreenError);
-    test('unexpected alert open', error.UnexpectedAlertOpenError);
-    test('unknown command', error.UnknownCommandError);
-    test('unknown method', error.UnknownMethodError);
-    test('unsupported operation', error.UnsupportedOperationError);
-
-    it('leaves remoteStacktrace empty if not in encoding', function() {
-      assert.throws(
-          () => error.throwDecodedError({
-            error: 'session not created',
-            message: 'oops'
-          }),
-          (e) => {
-            assert.strictEqual(e.constructor, error.SessionNotCreatedError);
-            assert.strictEqual(e.message, 'oops');
-            assert.strictEqual(e.remoteStacktrace, '');
-            return true;
-          });
-    });
-
-    function test(status, expectedType) {
-      it(`"${status}" => ${expectedType.name}`, function() {
-        assert.throws(
-            () => error.throwDecodedError({
-              error: status,
-              message: 'oops',
-              stacktrace: 'some-stacktrace'
-            }),
-            (e) => {
-              assert.strictEqual(e.constructor, expectedType);
-              assert.strictEqual(e.message, 'oops');
-              assert.strictEqual(e.remoteStacktrace, 'some-stacktrace');
-              return true;
-            });
-      });
-    }
-  });
-
-  describe('checkLegacyResponse', function() {
-    it('does not throw for success', function() {
-      let resp = {status: error.ErrorCode.SUCCESS};
-      assert.strictEqual(resp, error.checkLegacyResponse(resp));
-    });
-
-    test('NO_SUCH_ELEMENT', error.NoSuchElementError);
-    test('NO_SUCH_FRAME', error.NoSuchFrameError);
-    test('UNKNOWN_COMMAND', error.UnsupportedOperationError);
-    test('UNSUPPORTED_OPERATION', error.UnsupportedOperationError);
-    test('STALE_ELEMENT_REFERENCE', error.StaleElementReferenceError);
-    test('ELEMENT_NOT_VISIBLE', error.ElementNotVisibleError);
-    test('INVALID_ELEMENT_STATE', error.InvalidElementStateError);
-    test('UNKNOWN_ERROR', error.WebDriverError);
-    test('ELEMENT_NOT_SELECTABLE', error.ElementNotSelectableError);
-    test('JAVASCRIPT_ERROR', error.JavascriptError);
-    test('XPATH_LOOKUP_ERROR', error.InvalidSelectorError);
-    test('TIMEOUT', error.TimeoutError);
-    test('NO_SUCH_WINDOW', error.NoSuchWindowError);
-    test('INVALID_COOKIE_DOMAIN', error.InvalidCookieDomainError);
-    test('UNABLE_TO_SET_COOKIE', error.UnableToSetCookieError);
-    test('UNEXPECTED_ALERT_OPEN', error.UnexpectedAlertOpenError);
-    test('NO_SUCH_ALERT', error.NoSuchAlertError);
-    test('SCRIPT_TIMEOUT', error.ScriptTimeoutError);
-    test('INVALID_ELEMENT_COORDINATES', error.InvalidElementCoordinatesError);
-    test('INVALID_SELECTOR_ERROR', error.InvalidSelectorError);
-    test('SESSION_NOT_CREATED', error.SessionNotCreatedError);
-    test('MOVE_TARGET_OUT_OF_BOUNDS', error.MoveTargetOutOfBoundsError);
-    test('INVALID_XPATH_SELECTOR', error.InvalidSelectorError);
-    test('INVALID_XPATH_SELECTOR_RETURN_TYPE', error.InvalidSelectorError);
-    test('METHOD_NOT_ALLOWED', error.UnsupportedOperationError);
-
-    describe('UnexpectedAlertOpenError', function() {
-      it('includes alert text from the response object', function() {
-        let response = {
-          status: error.ErrorCode.UNEXPECTED_ALERT_OPEN,
-          value: {
-            message: 'hi',
-            alert: {text: 'alert text here'}
-          }
-        };
-        assert.throws(
-            () => error.checkLegacyResponse(response),
-            (e) => {
-              assert.equal(error.UnexpectedAlertOpenError, e.constructor);
-              assert.equal(e.message, 'hi');
-              assert.equal(e.getAlertText(), 'alert text here');
-              return true;
-            });
-      });
-
-      it('uses an empty string if alert text omitted', function() {
-        let response = {
-          status: error.ErrorCode.UNEXPECTED_ALERT_OPEN,
-          value: {
-            message: 'hi'
-          }
-        };
-        assert.throws(
-            () => error.checkLegacyResponse(response),
-            (e) => {
-              assert.equal(error.UnexpectedAlertOpenError, e.constructor);
-              assert.equal(e.message, 'hi');
-              assert.equal(e.getAlertText(), '');
-              return true;
-            });
-      });
-    });
-
-    function test(codeKey, expectedType) {
-      it(`${codeKey} => ${expectedType.name}`, function() {
-        let code = error.ErrorCode[codeKey];
-        let resp = {status: code, value: {message: 'hi'}};
-        assert.throws(
-            () => error.checkLegacyResponse(resp),
-            (e) => {
-              assert.equal(expectedType, e.constructor);
-              assert.equal(e.message, 'hi');
-              return true;
-            });
-      });
-    }
-  });
-});