selenium-webdriver 4.0.0-alpha.3 → 4.0.0-alpha.7

package/lib/test/httpserver.js

@@ -1,120 +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'),
-    http = require('http'),
-    url = require('url');
-
-var net = require('../../net'),
-    portprober = require('../../net/portprober'),
-    promise = require('../..').promise;
-
-
-
-/**
- * Encapsulates a simple HTTP server for testing. The {@code onrequest}
- * function should be overridden to define request handling behavior.
- * @param {function(!http.ServerRequest, !http.ServerResponse)} requestHandler
- *     The request handler for the server.
- * @constructor
- */
-var Server = function(requestHandler) {
-  var server = http.createServer(function(req, res) {
-    requestHandler(req, res);
-  });
-
-  server.on('connection', function(stream) {
-    stream.setTimeout(4000);
-  });
-
-  /** @typedef {{port: number, address: string, family: string}} */
-  var Host;
-
-  /**
-   * Starts the server on the given port. If no port, or 0, is provided,
-   * the server will be started on a random port.
-   * @param {number=} opt_port The port to start on.
-   * @return {!Promise<Host>} A promise that will resolve
-   *     with the server host when it has fully started.
-   */
-  this.start = function(opt_port) {
-    assert(typeof opt_port !== 'function',
-           "start invoked with function, not port (mocha callback)?");
-    var port = opt_port || portprober.findFreePort('localhost');
-    return Promise.resolve(port).then(port => {
-      return promise.checkedNodeCall(
-          server.listen.bind(server, port, 'localhost'));
-    }).then(function() {
-      return server.address();
-    });
-  };
-
-  /**
-   * Stops the server.
-   * @return {!Promise} A promise that will resolve when the
-   *     server has closed all connections.
-   */
-  this.stop = function() {
-    return new Promise(resolve => server.close(resolve));
-  };
-
-  /**
-   * @return {Host} This server's host info.
-   * @throws {Error} If the server is not running.
-   */
-  this.address = function() {
-    var addr = server.address();
-    if (!addr) {
-      throw Error('There server is not running!');
-    }
-    return addr;
-  };
-
-  /**
-   * return {string} The host:port of this server.
-   * @throws {Error} If the server is not running.
-   */
-  this.host = function() {
-    return net.getLoopbackAddress() + ':' +
-        this.address().port;
-  };
-
-  /**
-   * Formats a URL for this server.
-   * @param {string=} opt_pathname The desired pathname on the server.
-   * @return {string} The formatted URL.
-   * @throws {Error} If the server is not running.
-   */
-  this.url = function(opt_pathname) {
-    var addr = this.address();
-    var pathname = opt_pathname || '';
-    return url.format({
-      protocol: 'http',
-      hostname: net.getLoopbackAddress(),
-      port: addr.port,
-      pathname: pathname
-    });
-  };
-};
-
-
-// PUBLIC API
-
-
-exports.Server = Server;

package/lib/test/index.js

@@ -1,87 +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 assert = require('assert');
-
-const build = require('./build');
-const fileserver = require('./fileserver');
-const firefox = require('../../firefox');
-const logging = require('../../lib/logging');
-const remote = require('../../remote');
-const safari = require('../../safari');
-const testing = require('../../testing');
-const webdriver = require('../../');
-
-const NO_BUILD = /^1|true$/i.test(process.env['SELENIUM_NO_BUILD']);
-
-
-/**
- * @param {function(!testing.Environment)} fn The top level suite function.
- * @param {testing.SuiteOptions=} options Suite specific options.
- */
-function suite(fn, options = undefined) {
-  testing.suite(function(env) {
-    before(function() {
-      if (false && !NO_BUILD) {
-        return build.of(
-            '//javascript/atoms/fragments:is-displayed',
-            '//javascript/webdriver/atoms:get-attribute')
-            .onlyOnce().go();
-      }
-    });
-
-    fn(env);
-  }, options);
-}
-
-
-// GLOBAL TEST SETUP
-
-
-process.on('unhandledRejection', (reason) => {
-  console.error('Unhandled promise rejection:', reason);
-});
-
-
-if (/^1|true$/i.test(process.env['SELENIUM_VERBOSE'])) {
-  logging.installConsoleHandler();
-  logging.getLogger('webdriver.http').setLevel(logging.Level.ALL);
-}
-
-testing.init();
-
-before(function() {
-   // Do not pass register fileserver.start directly with testing.before,
-   // as start takes an optional port, which before assumes is an async
-   // callback.
-   return fileserver.start();
-});
-
-after(function() {
-   return fileserver.stop();
-});
-
-
-// PUBLIC API
-
-
-exports.suite = suite;
-exports.ignore = testing.ignore;
-exports.Pages = fileserver.Pages;
-exports.whereIs = fileserver.whereIs;

package/lib/test/resources.js

@@ -1,40 +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 fs = require('fs');
-const path = require('path');
-const {projectRoot} = require('./build');
-
-
-// PUBLIC API
-
-
-/**
- * Locates a test resource.
- * @param {string} filePath The file to locate from the root of the project.
- * @return {string} The full path for the file, if it exists.
- * @throws {Error} If the file does not exist.
- */
-exports.locate = function(filePath) {
-  var fullPath = path.normalize(path.join(projectRoot(), filePath));
-  if (!fs.existsSync(fullPath)) {
-    throw Error('File does not exist: ' + filePath);
-  }
-  return fullPath;
-};

package/test/actions_test.js

@@ -1,206 +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 assert = require('assert');
-
-const chrome = require('../chrome');
-const error = require('../lib/error');
-const fileServer = require('../lib/test/fileserver');
-const firefox = require('../firefox');
-const test = require('../lib/test');
-const {Key, Origin} = require('../lib/input');
-const {Browser, By, until} = require('..');
-
-test.suite(function(env) {
-  describe('WebDriver.actions()', function() {
-    let driver;
-
-    before(async function() {
-      driver = await env.builder().build();
-    });
-
-    afterEach(async function() {
-      try {
-        await driver.actions().clear();
-      } catch (e) {
-        if (e instanceof error.UnsupportedOperationError
-            || e instanceof error.UnknownCommandError) {
-          return;
-        }
-        throw e;
-      }
-    });
-
-    after(function() {
-      return driver.quit();
-    });
-
-    it('click(element)', async function() {
-      await driver.get(fileServer.whereIs('/data/actions/click.html'));
-
-      let box = await driver.findElement(By.id('box'));
-      assert.equal(await box.getAttribute('class'), '');
-
-      await driver.actions().click(box).perform();
-      assert.equal(await box.getAttribute('class'), 'green');
-    });
-
-    it('click(element) clicks in center of element', async function() {
-      await driver.get(fileServer.whereIs('/data/actions/record_click.html'));
-
-      const div = await driver.findElement(By.css('div'));
-      const rect = await div.getRect();
-      assert.deepEqual(rect, {width: 500, height: 500, x: 0, y: 0});
-
-      await driver.actions().click(div).perform();
-
-      const clicks = await driver.executeScript('return clicks');
-      assert.deepEqual(clicks, [[250, 250]]);
-    });
-
-    it('can move relative to element center', async function() {
-      await driver.get(fileServer.whereIs('/data/actions/record_click.html'));
-
-      const div = await driver.findElement(By.css('div'));
-      const rect = await div.getRect();
-      assert.deepEqual(rect, {width: 500, height: 500, x: 0, y: 0});
-
-      await driver.actions()
-          .move({x: 10, y: 10, origin: div})
-          .click()
-          .perform();
-
-      const clicks = await driver.executeScript('return clicks');
-      assert.deepEqual(clicks, [[260, 260]]);
-    });
-
-    test.ignore(env.browsers(Browser.SAFARI)).
-    it('doubleClick(element)', async function() {
-      await driver.get(fileServer.whereIs('/data/actions/click.html'));
-
-      let box = await driver.findElement(By.id('box'));
-      assert.equal(await box.getAttribute('class'), '');
-
-      await driver.actions().doubleClick(box).perform();
-      assert.equal(await box.getAttribute('class'), 'blue');
-    });
-
-    // For some reason for Chrome 75 we need to wrap this test in an extra
-    // describe for the afterEach hook above to properly clear action sequences.
-    // This appears to be a quirk of the timing around mocha tests and not
-    // necessarily a bug in the chromedriver.
-    // TODO(jleyba): dig into this more so we can remove this hack.
-    describe('dragAndDrop()', function() {
-      it('', async function() {
-        await driver.get(fileServer.whereIs('/data/actions/drag.html'));
-
-        let slide = await driver.findElement(By.id('slide'));
-        assert.equal(await slide.getCssValue('left'), '0px');
-        assert.equal(await slide.getCssValue('top'), '0px');
-
-        let br = await driver.findElement(By.id('BR'));
-        await driver.actions().dragAndDrop(slide, br).perform();
-        assert.equal(await slide.getCssValue('left'), '206px');
-        assert.equal(await slide.getCssValue('top'), '206px');
-
-        let tr = await driver.findElement(By.id('TR'));
-        await driver.actions().dragAndDrop(slide, tr).perform();
-        assert.equal(await slide.getCssValue('left'), '206px');
-        assert.equal(await slide.getCssValue('top'), '1px');
-      });
-    });
-
-    it('move()', async function() {
-      await driver.get(fileServer.whereIs('/data/actions/drag.html'));
-
-      let slide = await driver.findElement(By.id('slide'));
-      assert.equal(await slide.getCssValue('left'), '0px');
-      assert.equal(await slide.getCssValue('top'), '0px');
-
-      await driver.actions()
-          .move({origin: slide})
-          .press()
-          .move({x: 100, y: 100, origin: Origin.POINTER})
-          .release()
-          .perform();
-      assert.equal(await slide.getCssValue('left'), '101px');
-      assert.equal(await slide.getCssValue('top'), '101px');
-    });
-
-    it('can move to and click element in an iframe', async function() {
-      await driver.get(fileServer.whereIs('click_tests/click_in_iframe.html'));
-
-      await driver.wait(until.elementLocated(By.id('ifr')), 5000)
-          .then(frame => driver.switchTo().frame(frame));
-
-      let link = await driver.findElement(By.id('link'));
-
-      await driver.actions().click(link).perform();
-      await driver.switchTo().defaultContent();
-      return driver.wait(until.titleIs('Submitted Successfully!'), 5000);
-    });
-
-    it('can send keys to focused element', async function() {
-      await driver.get(test.Pages.formPage);
-
-      let el = await driver.findElement(By.id('email'));
-      assert.equal(await el.getAttribute('value'), '');
-
-      await driver.executeScript('arguments[0].focus()', el);
-
-      await driver.actions().sendKeys('foobar').perform();
-
-      assert.equal(await el.getAttribute('value'), 'foobar');
-    });
-
-    it('can send keys to focused element (with modifiers)', async function() {
-      await driver.get(test.Pages.formPage);
-
-      let el = await driver.findElement(By.id('email'));
-      assert.equal(await el.getAttribute('value'), '');
-
-      await driver.executeScript('arguments[0].focus()', el);
-
-      await driver.actions()
-          .sendKeys('fo')
-          .keyDown(Key.SHIFT)
-          .sendKeys('OB')
-          .keyUp(Key.SHIFT)
-          .sendKeys('ar')
-          .perform();
-
-      assert.equal(await el.getAttribute('value'), 'foOBar');
-    });
-
-    it('can interact with simple form elements', async function() {
-      await driver.get(test.Pages.formPage);
-
-      let el = await driver.findElement(By.id('email'));
-      assert.equal(await el.getAttribute('value'), '');
-
-      await driver.actions()
-          .click(el)
-          .sendKeys('foobar')
-          .perform();
-
-      assert.equal(await el.getAttribute('value'), 'foobar');
-    });
-  });
-});
-

package/test/builder_test.js

@@ -1,106 +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 assert = require('assert');
-
-const chrome = require('../chrome');
-const edge = require('../edge');
-const error = require('../lib/error');
-const firefox = require('../firefox');
-const ie = require('../ie');
-const safari = require('../safari');
-const test = require('../lib/test');
-const {Browser} = require('../lib/capabilities');
-const {Pages} = require('../lib/test');
-const {Builder, Capabilities, WebDriver} = require('..');
-
-
-test.suite(function(env) {
-  const browsers = (...args) => env.browsers(...args);
-
-  const BROWSER_MAP = new Map([
-    [Browser.CHROME, chrome.Driver],
-    [Browser.EDGE, edge.Driver],
-    [Browser.FIREFOX, firefox.Driver],
-    [Browser.INTERNET_EXPLORER, ie.Driver],
-    [Browser.SAFARI, safari.Driver],
-  ]);
-
-  if (BROWSER_MAP.has(env.browser.name)) {
-    describe('builder creates thenable driver instances', function() {
-      let driver;
-
-      after(() => driver && driver.quit());
-
-      it(env.browser.name, function() {
-        driver = env.builder().build();
-
-        const want = BROWSER_MAP.get(env.browser.name);
-        assert.ok(
-            driver instanceof want,
-            `want ${want.name}, but got ${driver.name}`);
-        assert.equal(typeof driver.then, 'function');
-
-        return driver
-            .then(
-                d =>
-                    assert.ok(
-                        d instanceof want,
-                        `want ${want.name}, but got ${d.name}`))
-            // Load something so the safari driver doesn't crash from starting and
-            // stopping in short time.
-            .then(() => driver.get(Pages.echoPage));
-      });
-    });
-  }
-
-  class OptionsTest {
-    constructor(ctor, key) {
-      this.ctor = ctor;
-      this.key = key;
-    }
-  }
-
-});
-
-describe('Builder', function() {
-  describe('catches incorrect use of browser options class', function() {
-    function test(key, options) {
-      it(key, async function() {
-        let builder = new Builder()
-            .withCapabilities(new Capabilities()
-                .set('browserName', 'fake-browser-should-not-try-to-start')
-                .set(key, new options()));
-        try {
-          let driver = await builder.build();
-          await driver.quit();
-          return Promise.reject(Error('should have failed'));
-        } catch (ex) {
-          if (!(ex instanceof error.InvalidArgumentError)) {
-            throw ex;
-          }
-        }
-      });
-    }
-
-    test('chromeOptions', chrome.Options);
-    test('moz:firefoxOptions', firefox.Options);
-    test('safari.options', safari.Options);
-  });
-});

package/test/chrome/devtools_test.js

@@ -1,93 +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 assert = require('assert');
-const fs = require('fs');
-const path = require('path');
-
-const chrome = require('../../chrome');
-const error = require('../../lib/error');
-const fileServer = require('../../lib/test/fileserver');
-const io = require('../../io');
-const test = require('../../lib/test');
-const webdriver = require('../..');
-
-test.suite(function(env) {
-  let driver;
-
-  before(async function() {
-    driver = await env.builder()
-        .setChromeOptions(new chrome.Options().headless())
-        .build();
-  });
-  after(() => driver.quit());
-
-  it('can send commands to devtools', async function() {
-    await driver.get(test.Pages.ajaxyPage);
-    assert.equal(await driver.getCurrentUrl(), test.Pages.ajaxyPage);
-
-    await driver.sendDevToolsCommand(
-        'Page.navigate', {url: test.Pages.echoPage});
-    assert.equal(await driver.getCurrentUrl(), test.Pages.echoPage);
-  });
-
-  describe('setDownloadPath', function() {
-    it('can enable downloads in headless mode', async function() {
-      const dir = await io.tmpDir();
-      await driver.setDownloadPath(dir);
-
-      const url = fileServer.whereIs('/data/firefox/webextension.xpi');
-      await driver.get(`data:text/html,<!DOCTYPE html>
-  <div><a download="" href="${url}">Go!</a></div>`);
-
-      await driver.findElement({css: 'a'}).click();
-
-      const downloadPath = path.join(dir, 'webextension.xpi');
-      await driver.wait(() => io.exists(downloadPath), 5000);
-
-      const goldenPath =
-          path.join(__dirname, '../../lib/test/data/firefox/webextension.xpi');
-      assert.equal(
-          fs.readFileSync(downloadPath, 'binary'),
-          fs.readFileSync(goldenPath, 'binary'));
-    });
-
-    it('throws if path is not a directory', async function() {
-      await assertInvalidArgumentError(() => driver.setDownloadPath());
-      await assertInvalidArgumentError(() => driver.setDownloadPath(null));
-      await assertInvalidArgumentError(() => driver.setDownloadPath(''));
-      await assertInvalidArgumentError(() => driver.setDownloadPath(1234));
-
-      const file = await io.tmpFile();
-      await assertInvalidArgumentError(() => driver.setDownloadPath(file));
-
-      async function assertInvalidArgumentError(fn) {
-        try {
-          await fn();
-          return Promise.reject(Error('should have failed'));
-        } catch (err) {
-          if (err instanceof error.InvalidArgumentError) {
-            return;
-          }
-          throw err;
-        }
-      }
-    });
-  });
-}, {browsers: ['chrome']});