selenium-webdriver 3.5.0 → 4.0.0-alpha.4

package/lib/test/fileserver.js

@@ -1,321 +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 fs = require('fs'),
-    http = require('http'),
-    path = require('path'),
-    url = require('url');
-
-var express = require('express');
-var multer = require('multer');
-var serveIndex = require('serve-index');
-
-var Server = require('./httpserver').Server,
-    resources = require('./resources'),
-    isDevMode = require('../devmode');
-
-var WEB_ROOT = '/common';
-var JS_ROOT = '/javascript';
-
-var baseDirectory = resources.locate(isDevMode ? 'common/src/web' : '.');
-var jsDirectory = resources.locate(isDevMode ? 'javascript' : '..');
-
-var Pages = (function() {
-  var pages = {};
-  function addPage(page, path) {
-    pages.__defineGetter__(page, function() {
-      return exports.whereIs(path);
-    });
-  }
-
-  addPage('ajaxyPage', 'ajaxy_page.html');
-  addPage('alertsPage', 'alerts.html');
-  addPage('bodyTypingPage', 'bodyTypingTest.html');
-  addPage('booleanAttributes', 'booleanAttributes.html');
-  addPage('childPage', 'child/childPage.html');
-  addPage('chinesePage', 'cn-test.html');
-  addPage('clickJacker', 'click_jacker.html');
-  addPage('clickEventPage', 'clickEventPage.html');
-  addPage('clicksPage', 'clicks.html');
-  addPage('colorPage', 'colorPage.html');
-  addPage('deletingFrame', 'deletingFrame.htm');
-  addPage('draggableLists', 'draggableLists.html');
-  addPage('dragAndDropPage', 'dragAndDropTest.html');
-  addPage('droppableItems', 'droppableItems.html');
-  addPage('documentWrite', 'document_write_in_onload.html');
-  addPage('dynamicallyModifiedPage', 'dynamicallyModifiedPage.html');
-  addPage('dynamicPage', 'dynamic.html');
-  addPage('echoPage', 'echo');
-  addPage('errorsPage', 'errors.html');
-  addPage('xhtmlFormPage', 'xhtmlFormPage.xhtml');
-  addPage('formPage', 'formPage.html');
-  addPage('formSelectionPage', 'formSelectionPage.html');
-  addPage('framesetPage', 'frameset.html');
-  addPage('grandchildPage', 'child/grandchild/grandchildPage.html');
-  addPage('html5Page', 'html5Page.html');
-  addPage('html5OfflinePage', 'html5/offline.html');
-  addPage('iframePage', 'iframes.html');
-  addPage('javascriptEnhancedForm', 'javascriptEnhancedForm.html');
-  addPage('javascriptPage', 'javascriptPage.html');
-  addPage('linkedImage', 'linked_image.html');
-  addPage('longContentPage', 'longContentPage.html');
-  addPage('macbethPage', 'macbeth.html');
-  addPage('mapVisibilityPage', 'map_visibility.html');
-  addPage('metaRedirectPage', 'meta-redirect.html');
-  addPage('missedJsReferencePage', 'missedJsReference.html');
-  addPage('mouseTrackerPage', 'mousePositionTracker.html');
-  addPage('nestedPage', 'nestedElements.html');
-  addPage('readOnlyPage', 'readOnlyPage.html');
-  addPage('rectanglesPage', 'rectangles.html');
-  addPage('redirectPage', 'redirect');
-  addPage('resultPage', 'resultPage.html');
-  addPage('richTextPage', 'rich_text.html');
-  addPage('selectableItemsPage', 'selectableItems.html');
-  addPage('selectPage', 'selectPage.html');
-  addPage('simpleTestPage', 'simpleTest.html');
-  addPage('simpleXmlDocument', 'simple.xml');
-  addPage('sleepingPage', 'sleep');
-  addPage('slowIframes', 'slow_loading_iframes.html');
-  addPage('slowLoadingAlertPage', 'slowLoadingAlert.html');
-  addPage('svgPage', 'svgPiechart.xhtml');
-  addPage('tables', 'tables.html');
-  addPage('underscorePage', 'underscore.html');
-  addPage('unicodeLtrPage', 'utf8/unicode_ltr.html');
-  addPage('uploadPage', 'upload.html');
-  addPage('veryLargeCanvas', 'veryLargeCanvas.html');
-  addPage('xhtmlTestPage', 'xhtmlTest.html');
-
-  return pages;
-})();
-
-
-var Path = {
-  BASIC_AUTH: WEB_ROOT + '/basicAuth',
-  ECHO: WEB_ROOT + '/echo',
-  GENERATED: WEB_ROOT + '/generated',
-  MANIFEST: WEB_ROOT + '/manifest',
-  REDIRECT: WEB_ROOT + '/redirect',
-  PAGE: WEB_ROOT + '/page',
-  SLEEP: WEB_ROOT + '/sleep',
-  UPLOAD: WEB_ROOT + '/upload'
-};
-
-var app = express();
-
-app.get('/', sendIndex)
-.get('/favicon.ico', function(req, res) {
-  res.writeHead(204);
-  res.end();
-})
-.use(JS_ROOT, serveIndex(jsDirectory), express.static(jsDirectory))
-.post(Path.UPLOAD, handleUpload)
-.use(WEB_ROOT, serveIndex(baseDirectory), express.static(baseDirectory))
-.get(Path.ECHO, sendEcho)
-.get(Path.PAGE, sendInifinitePage)
-.get(Path.PAGE + '/*', sendInifinitePage)
-.get(Path.REDIRECT, redirectToResultPage)
-.get(Path.SLEEP, sendDelayedResponse)
-
-if (isDevMode) {
-  var closureDir = resources.locate('third_party/closure/goog');
-  app.use('/third_party/closure/goog',
-      serveIndex(closureDir), express.static(closureDir));
-}
-var server = new Server(app);
-
-
-function redirectToResultPage(_, response) {
-  response.writeHead(303, {
-    Location: Pages.resultPage
-  });
-  return response.end();
-}
-
-
-function sendInifinitePage(request, response) {
-  var pathname = url.parse(request.url).pathname;
-  var lastIndex = pathname.lastIndexOf('/');
-  var pageNumber =
-      (lastIndex == -1 ? 'Unknown' : pathname.substring(lastIndex + 1));
-  var body = [
-    '<!DOCTYPE html>',
-    '<title>Page', pageNumber, '</title>',
-    'Page number <span id="pageNumber">', pageNumber, '</span>',
-    '<p><a href="../xhtmlTest.html" target="_top">top</a>'
-  ].join('');
-  response.writeHead(200, {
-    'Content-Length': Buffer.byteLength(body, 'utf8'),
-    'Content-Type': 'text/html; charset=utf-8'
-  });
-  response.end(body);
-}
-
-
-function sendDelayedResponse(request, response) {
-  var duration = 0;
-  var query = url.parse(request.url).query || '';
-  var match = query.match(/\btime=(\d+)/);
-  if (match) {
-    duration = parseInt(match[1], 10);
-  }
-
-  setTimeout(function() {
-    var body = [
-      '<!DOCTYPE html>',
-      '<title>Done</title>',
-      '<body>Slept for ', duration, 's</body>'
-    ].join('');
-    response.writeHead(200, {
-      'Content-Length': Buffer.byteLength(body, 'utf8'),
-      'Content-Type': 'text/html; charset=utf-8',
-      'Cache-Control': 'no-cache',
-      'Pragma': 'no-cache',
-      'Expires': 0
-    });
-    response.end(body);
-  }, duration * 1000);
-}
-
-
-function handleUpload(request, response) {
-  let upload = multer({storage: multer.memoryStorage()}).any();
-  upload(request, response, function(err) {
-    if (err) {
-      response.writeHead(500);
-      response.end(err + '');
-    } else {
-      response.writeHead(200);
-      response.write(request.files[0].buffer);
-      response.end('<script>window.top.window.onUploadDone();</script>');
-    }
-  });
-}
-
-
-function sendEcho(request, response) {
-  var body = [
-    '<!DOCTYPE html>',
-    '<title>Echo</title>',
-    '<div class="request">',
-    request.method, ' ', request.url, ' ', 'HTTP/', request.httpVersion,
-    '</div>'
-  ];
-  for (var name in request.headers) {
-    body.push('<div class="header ', name , '">',
-        name, ': ', request.headers[name], '</div>');
-  }
-  body = body.join('');
-  response.writeHead(200, {
-    'Content-Length': Buffer.byteLength(body, 'utf8'),
-    'Content-Type': 'text/html; charset=utf-8'
-  });
-  response.end(body);
-}
-
-
-/**
- * Responds to a request for the file server's main index.
- * @param {!http.ServerRequest} request The request object.
- * @param {!http.ServerResponse} response The response object.
- */
-function sendIndex(request, response) {
-  var pathname = url.parse(request.url).pathname;
-
-  var host = request.headers.host;
-  if (!host) {
-    host = server.host();
-  }
-
-  var requestUrl = ['http://' + host + pathname].join('');
-
-  function createListEntry(path) {
-    var url = requestUrl + path;
-    return ['<li><a href="', url, '">', path, '</a>'].join('');
-  }
-
-  var data = ['<!DOCTYPE html><h1>/</h1><hr/><ul>',
-              createListEntry('common')];
-  if (isDevMode) {
-    data.push(createListEntry('javascript'));
-  }
-  data.push('</ul>');
-  data = data.join('');
-
-  response.writeHead(200, {
-    'Content-Type': 'text/html; charset=UTF-8',
-    'Content-Length': Buffer.byteLength(data, 'utf8')
-  });
-  response.end(data);
-}
-
-
-// PUBLIC application
-
-
-/**
- * Starts the server on the specified port.
- * @param {number=} opt_port The port to use, or 0 for any free port.
- * @return {!Promise<Host>} A promise that will resolve
- *     with the server host when it has fully started.
- */
-exports.start = server.start.bind(server);
-
-
-/**
- * Stops the server.
- * @return {!Promise} A promise that will resolve when the
- *     server has closed all connections.
- */
-exports.stop = server.stop.bind(server);
-
-
-/**
- * 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.
- */
-exports.url = server.url.bind(server);
-
-
-/**
- * Builds the URL for a file in the //common/src/web directory of the
- * Selenium client.
- * @param {string} filePath A path relative to //common/src/web to compute a
- *     URL for.
- * @return {string} The formatted URL.
- * @throws {Error} If the server is not running.
- */
-exports.whereIs = function(filePath) {
-  filePath = filePath.replace(/\\/g, '/');
-  if (!filePath.startsWith('/')) {
-    filePath = '/' + filePath;
-  }
-  return server.url(WEB_ROOT + filePath);
-};
-
-
-exports.Pages = Pages;
-
-
-if (require.main === module) {
-  server.start(2310).then(function() {
-    console.log('Server running at ' + server.url());
-  });
-}

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,270 +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 build = require('./build'),
-    isDevMode = require('../devmode'),
-    webdriver = require('../../'),
-    flow = webdriver.promise.controlFlow(),
-    firefox = require('../../firefox'),
-    logging = require('../../lib/logging'),
-    safari = require('../../safari'),
-    remote = require('../../remote'),
-    testing = require('../../testing'),
-    fileserver = require('./fileserver');
-
-
-/**
- * Browsers with native support.
- * @type {!Array.<webdriver.Browser>}
- */
-var NATIVE_BROWSERS = [
-  webdriver.Browser.CHROME,
-  webdriver.Browser.EDGE,
-  webdriver.Browser.FIREFOX,
-  webdriver.Browser.IE,
-  webdriver.Browser.OPERA,
-  webdriver.Browser.PHANTOM_JS,
-  webdriver.Browser.SAFARI
-];
-
-
-var noBuild = /^1|true$/i.test(process.env['SELENIUM_NO_BUILD']);
-var serverJar = process.env['SELENIUM_SERVER_JAR'];
-var remoteUrl = process.env['SELENIUM_REMOTE_URL'];
-var useLoopback = process.env['SELENIUM_USE_LOOP_BACK'] == '1';
-var startServer = !!serverJar && !remoteUrl;
-var nativeRun = !serverJar && !remoteUrl;
-
-if (/^1|true$/i.test(process.env['SELENIUM_VERBOSE'])) {
-  logging.installConsoleHandler();
-  logging.getLogger('webdriver.http').setLevel(logging.Level.ALL);
-}
-
-var browsersToTest = (function() {
-  var permitRemoteBrowsers = !!remoteUrl || !!serverJar;
-  var permitUnknownBrowsers = !nativeRun;
-  var browsers = process.env['SELENIUM_BROWSER'] || webdriver.Browser.FIREFOX;
-
-  browsers = browsers.split(',').map(function(browser) {
-    var parts = browser.split(/:/);
-    if (parts[0] === 'ie') {
-      parts[0] = webdriver.Browser.IE;
-    }
-    if (parts[0] === 'edge') {
-      parts[0] = webdriver.Browser.EDGE;
-    }
-    return parts.join(':');
-  });
-
-  browsers.forEach(function(browser) {
-    var parts = browser.split(/:/, 3);
-    if (parts[0] === 'ie') {
-      parts[0] = webdriver.Browser.IE;
-    }
-
-    if (NATIVE_BROWSERS.indexOf(parts[0]) == -1 && !permitRemoteBrowsers) {
-      throw Error('Browser ' + parts[0] + ' requires a WebDriver server and ' +
-          'neither the SELENIUM_REMOTE_URL nor the SELENIUM_SERVER_JAR ' +
-          'environment variables have been set.');
-    }
-
-    var recognized = false;
-    for (var prop in webdriver.Browser) {
-      if (webdriver.Browser.hasOwnProperty(prop) &&
-          webdriver.Browser[prop] === parts[0]) {
-        recognized = true;
-        break;
-      }
-    }
-
-    if (!recognized && !permitUnknownBrowsers) {
-      throw Error('Unrecognized browser: ' + browser);
-    }
-  });
-
-  console.log('Running tests against [' + browsers.join(',') + ']');
-  if (remoteUrl) {
-    console.log('Using remote server ' + remoteUrl);
-  } else if (serverJar) {
-    console.log('Using standalone Selenium server ' + serverJar);
-    if (useLoopback) {
-      console.log('Running tests using loopback address')
-    }
-  }
-  console.log(
-      'Promise manager is enabled? ' + webdriver.promise.USE_PROMISE_MANAGER);
-
-  return browsers;
-})();
-
-
-/**
- * Creates a predicate function that ignores tests for specific browsers.
- * @param {string} currentBrowser The name of the current browser.
- * @param {!Array.<!Browser>} browsersToIgnore The browsers to ignore.
- * @return {function(): boolean} The predicate function.
- */
-function browsers(currentBrowser, browsersToIgnore) {
-  return function() {
-    return browsersToIgnore.indexOf(currentBrowser) != -1;
-  };
-}
-
-
-/**
- * @param {string} browserName The name to use.
- * @param {remote.DriverService} server The server to use, if any.
- * @constructor
- */
-function TestEnvironment(browserName, server) {
-  var name = browserName;
-
-  this.currentBrowser = function() {
-    return browserName;
-  };
-
-  this.isRemote = function() {
-    return server || remoteUrl;
-  };
-
-  this.browsers = function(var_args) {
-    var browsersToIgnore = Array.prototype.slice.apply(arguments, [0]);
-    return browsers(browserName, browsersToIgnore);
-  };
-
-  this.builder = function() {
-    var builder = new webdriver.Builder();
-    var realBuild = builder.build;
-
-    builder.build = function() {
-      let parts = browserName.split(/:/, 3);
-
-      builder.forBrowser(parts[0], parts[1], parts[2]);
-      if (server) {
-        builder.usingServer(server.address());
-      } else if (remoteUrl) {
-        builder.usingServer(remoteUrl);
-      }
-
-      builder.disableEnvironmentOverrides();
-      return realBuild.call(builder);
-    };
-
-    return builder;
-  };
-}
-
-
-var seleniumServer;
-var inSuite = false;
-
-
-/**
- * Expands a function to cover each of the target browsers.
- * @param {function(!TestEnvironment)} fn The top level suite
- *     function.
- * @param {{browsers: !Array.<string>}=} opt_options Suite specific options.
- */
-function suite(fn, opt_options) {
-  assert.ok(!inSuite, 'You may not nest suite calls');
-  inSuite = true;
-
-  var suiteOptions = opt_options || {};
-  var browsers = suiteOptions.browsers;
-  if (browsers) {
-    // Filter out browser specific tests when that browser is not currently
-    // selected for testing.
-    browsers = browsers.filter(function(browser) {
-      return browsersToTest.indexOf(browser) != -1;
-    });
-  } else {
-    browsers = browsersToTest;
-  }
-
-  try {
-
-    before(function() {
-      if (isDevMode && !noBuild) {
-        return build.of(
-            '//javascript/atoms/fragments:is-displayed',
-            '//javascript/webdriver/atoms:getAttribute')
-            .onlyOnce().go();
-      }
-    });
-
-    // Server is only started if required for a specific config.
-    after(function() {
-      if (seleniumServer) {
-        return seleniumServer.stop();
-      }
-    });
-
-    browsers.forEach(function(browser) {
-      describe('[' + browser + ']', function() {
-
-        var serverToUse = null;
-
-        if (!!serverJar && !remoteUrl) {
-          if (!(serverToUse = seleniumServer)) {
-            serverToUse = seleniumServer = new remote.SeleniumServer(
-                serverJar, {loopback: useLoopback});
-          }
-
-          before(function() {
-            this.timeout(0);
-            return seleniumServer.start(60 * 1000);
-          });
-        }
-        fn(new TestEnvironment(browser, serverToUse));
-      });
-    });
-  } finally {
-    inSuite = false;
-  }
-}
-
-
-// GLOBAL TEST SETUP
-
-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.after = testing.after;
-exports.afterEach = testing.afterEach;
-exports.before = testing.before;
-exports.beforeEach = testing.beforeEach;
-exports.it = testing.it;
-exports.ignore = testing.ignore;
-
-exports.Pages = fileserver.Pages;
-exports.whereIs = fileserver.whereIs;