selenium-webdriver 3.6.0 → 4.0.0-alpha.1

package/lib/proxy.js

@@ -18,26 +18,126 @@
 /**
  * @fileoverview Defines functions for configuring a webdriver proxy:
  *
- *     const Capabilities = require('./capabilities').Capabilities;
+ *     const proxy = require('selenium-webdriver/proxy');
+ *     const {Capabilities} = require('selenium-webdriver');
  *
- *     var capabilities = new Capabilities();
+ *     let capabilities = new Capabilities();
  *     capabilities.setProxy(proxy.manual({http: 'host:1234'});
  */
 
 'use strict';
 
-var ProxyConfig = require('./capabilities').ProxyConfig;
+/**
+ * Supported {@linkplain Config proxy configuration} types.
+ *
+ * @enum {string}
+ */
+const Type = {
+  AUTODETECT: 'autodetect',
+  DIRECT: 'direct',
+  MANUAL: 'manual',
+  PAC: 'pac',
+  SYSTEM: 'system',
+};
+
+
+/**
+ * Describes how a proxy should be configured for a WebDriver session.
+ * @record
+ */
+function Config() {}
+
+/**
+ * The proxy type.
+ * @type {Type}
+ */
+Config.prototype.proxyType;
+
+
+/**
+ * Describes how to configure a PAC proxy.
+ * @record
+ * @extends {Config}
+ */
+function PacConfig() {}
+
+/**
+ * URL for the PAC file to use.
+ *
+ * @type {string}
+ */
+PacConfig.prototype.proxyAutoconfigUrl;
+
+
+/**
+ * Record object that defines a manual proxy configuration. Manual
+ * configurations can be easily created using either the
+ * {@link ./proxy.manual proxy.manual()} or {@link ./proxy.socks proxy.socks()}
+ * factory method.
+ *
+ * @record
+ * @extends {Config}
+ */
+function ManualConfig() {}
+
+/**
+ * The proxy host for FTP requests.
+ *
+ * @type {(string|undefined)}
+ */
+ManualConfig.prototype.ftpProxy;
+
+/**
+ * The proxy host for HTTP requests.
+ *
+ * @type {(string|undefined)}
+ */
+ManualConfig.prototype.httpProxy;
+
+/**
+ * An array of hosts which should bypass all proxies.
+ *
+ * @type {(Array<string>|undefined)}
+ */
+ManualConfig.prototype.noProxy;
+
+/**
+ * The proxy host for HTTPS requests.
+ *
+ * @type {(string|undefined)}
+ */
+ManualConfig.prototype.sslProxy;
+
+/**
+ * Defines the host and port for the SOCKS proxy to use.
+ *
+ * @type {(number|undefined)}
+ */
+ManualConfig.prototype.socksProxy;
+
+/**
+ * Defines the SOCKS proxy version. Must be a number in the range [0, 255].
+ *
+ * @type {(number|undefined)}
+ */
+ManualConfig.prototype.socksVersion;
 
 
 // PUBLIC API
 
 
+/** @const */ exports.Config = Config;
+/** @const */ exports.ManualConfig = ManualConfig;
+/** @const */ exports.PacConfig = PacConfig;
+/** @const */ exports.Type = Type;
+
+
 /**
  * Configures WebDriver to bypass all browser proxies.
- * @return {!ProxyConfig} A new proxy configuration object.
+ * @return {!Config} A new proxy configuration object.
  */
 exports.direct = function() {
-  return {proxyType: 'direct'};
+  return {proxyType: Type.DIRECT};
 };
 
 
@@ -58,21 +158,18 @@ exports.direct = function() {
  * @param {{ftp: (string|undefined),
  *          http: (string|undefined),
  *          https: (string|undefined),
- *          bypass: (string|!Array.<string>|undefined)}} options Proxy
+ *          bypass: (Array<string>|undefined)}} options Proxy
  *     configuration options.
- * @return {!ProxyConfig} A new proxy configuration object.
- */
-exports.manual = function(options) {
-  // TODO(jleyba): Figure out why the Closure compiler does not think this is
-  // a ProxyConfig record without the cast.
-  return /** @type {!ProxyConfig} */({
-    proxyType: 'manual',
-    ftpProxy: options.ftp,
-    httpProxy: options.http,
-    sslProxy: options.https,
-    noProxy: Array.isArray(options.bypass) ?
-        options.bypass.join(',') : options.bypass
-  });
+ * @return {!ManualConfig} A new proxy configuration object.
+ */
+exports.manual = function({ftp, http, https, bypass}) {
+  return {
+    proxyType: Type.MANUAL,
+    ftpProxy: ftp,
+    httpProxy: http,
+    sslProxy: https,
+    noProxy: bypass,
+  };
 };
 
 
@@ -85,21 +182,22 @@ exports.manual = function(options) {
  *     const proxy = require('selenium-webdriver/lib/proxy');
  *
  *     let capabilities = new Capabilities();
- *     capabilities.setProxy(proxy.socks('localhost:1234', 'bob', 'password'));
+ *     capabilities.setProxy(proxy.socks('localhost:1234'));
  *
+ *     // Or, to include authentication.
+ *     capabilities.setProxy(proxy.socks('bob:password@localhost:1234'));
  *
- * @param {string} host The proxy host, in the form `hostname:port`.
- * @param {string} username The user name to authenticate as.
- * @param {string} password The password to authenticate with.
- * @return {!ProxyConfig} A new proxy configuration object.
+ *
+ * @param {string} socksProxy The proxy host, in the form `hostname:port`.
+ * @param {number=} socksVersion The SOCKS proxy version.
+ * @return {!ManualConfig} A new proxy configuration object.
  * @see https://en.wikipedia.org/wiki/SOCKS
  */
-exports.socks = function(host, username, password) {
-  return /** @type {!ProxyConfig} */({
-    proxyType: 'manual',
-    socksProxy: host,
-    socksUsername: username,
-    socksPassword: password
+exports.socks = function(socksProxy, socksVersion = undefined) {
+  return /** @type {!Config} */({
+    proxyType: Type.MANUAL,
+    socksProxy,
+    socksVersion
   });
 };
 
@@ -107,21 +205,18 @@ exports.socks = function(host, username, password) {
 /**
  * Configures WebDriver to configure the browser proxy using the PAC file at
  * the given URL.
- * @param {string} url URL for the PAC proxy to use.
- * @return {!ProxyConfig} A new proxy configuration object.
+ * @param {string} proxyAutoconfigUrl URL for the PAC proxy to use.
+ * @return {!PacConfig} A new proxy configuration object.
  */
-exports.pac = function(url) {
-  return {
-    proxyType: 'pac',
-    proxyAutoconfigUrl: url
-  };
+exports.pac = function(proxyAutoconfigUrl) {
+  return {proxyType: Type.PAC, proxyAutoconfigUrl};
 };
 
 
 /**
  * Configures WebDriver to use the current system's proxy.
- * @return {!ProxyConfig} A new proxy configuration object.
+ * @return {!Config} A new proxy configuration object.
  */
 exports.system = function() {
-  return {proxyType: 'system'};
+  return {proxyType: Type.SYSTEM};
 };

package/lib/test/bootstrap_jasmine.js

@@ -0,0 +1,28 @@
+// 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';
+
+/**
+ * @fileoverview Defines necessary adapaters for jasmine to have an equivalent
+ * API to mocha.
+ */
+
+global.after = global.afterAll;
+global.before = global.beforeAll;
+
+global.jasmine.DEFAULT_TIMEOUT_INTERVAL = 120 * 1000;

package/lib/test/data/actions/click.html

@@ -0,0 +1,24 @@
+<!DOCTYPE html>
+<style>
+body {
+  margin: 0;
+  padding: 0;
+}
+#box {
+  background: red;
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100px;
+  height: 100px;
+}
+#box.green { background: green; }
+#box.blue { background: blue; }
+</style>
+<body>
+<div id="box" onclick="setColor('green');" ondblclick="setColor('blue');"></div>
+<script>
+function setColor(c) {
+  document.getElementById('box').className = c;
+}
+</script>

package/lib/test/data/actions/drag.html

@@ -0,0 +1,77 @@
+<!DOCTYPE html>
+<style>
+body {
+  margin: 0;
+  padding: 0;
+}
+div {
+  position: absolute;
+  width: 50px;
+  height: 50px;
+  left: 0;
+  top: 0;
+}
+#TR { left: 206px; }
+#BL { top: 206px; }
+#BR { left: 206px; top: 206px; }
+#container {
+  width: 256px;
+  height: 256px;
+  left: 0;
+  top: 0;
+  border: 1px solid black;
+}
+#slide {
+  background: silver;
+  z-index: 1;
+}
+</style>
+<body>
+  <div id="container">
+    <div id="slide"></div>
+    <div id="TR"></div>
+    <div id="BR"></div>
+    <div id="BL"></div>
+  </div>
+  <script>
+    let offset;
+    let mouseDown = false;
+    let slide = document.getElementById('slide');
+    slide.addEventListener('mousedown', function(e) {
+      mouseDown = true;
+
+      let bbox = slide.getBoundingClientRect();
+      offset = {
+        x: e.clientX - bbox.left,
+        y: e.clientY - bbox.top
+      };
+    });
+
+    let container = document.getElementById('container');
+
+    let slideBox = slide.getBoundingClientRect();
+    let containerBox = container.getBoundingClientRect();
+    let maxLeft = containerBox.width - slideBox.width - 2;
+    let maxTop = containerBox.height - slideBox.height - 2;
+
+    container.addEventListener('mousemove', function(e) {
+      if (!mouseDown) return;
+
+      let bbox = slide.getBoundingClientRect();
+      let newLeft = e.clientX - offset.x;
+      newLeft = Math.max(newLeft, 0);
+      newLeft = Math.min(newLeft, maxLeft);
+
+      let newTop = e.clientY - offset.y;
+      newTop = Math.max(newTop, 0);
+      newTop = Math.min(newTop, maxTop);
+
+      slide.style.top = `${newTop}px`;
+      slide.style.left = `${newLeft}px`;
+    });
+
+    document.body.addEventListener('mouseup', function() {
+      mouseDown = false;
+    });
+  </script>
+</body>

package/lib/test/data/actions/record_click.html

@@ -0,0 +1,21 @@
+ <!DOCTYPE html>
+<style>
+body {
+  margin: 0;
+  padding: 0;
+}
+div {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 500px;
+  height: 500px;
+  background: green;
+}
+</style>
+<div></div>
+<script>
+var clicks = [];
+document.querySelector('div')
+    .addEventListener('click', e => clicks.push([e.clientX, e.clientY]));
+</script>

package/lib/test/data/chrome/download.html

@@ -0,0 +1,2 @@
+<!DOCTYPE html>
+<h1>Hello, world!</h1>

package/lib/test/data/inputs.html

@@ -0,0 +1,42 @@
+<html>
+<head>
+    <title>inputs</title>
+</head>
+<body>
+<h1>Testing Inputs</h1>
+
+<form action="#">
+  <input name="no_type" value="input with no type" /><br/>
+  <br/>
+  <input name="number_input" type="number" value="42" /><br/>
+  <input name="range_input" type="range" value="42" /><br/>
+  <br/>
+  <input name="email_input" type="email" value="admin@localhost" /><br/>
+  <input name="password_input" type="password" value="qwerty" /><br/>
+  <input name="search_input" type="search" value="search" /><br/>
+  <input name="tel_input" type="tel" value="911" /><br/>
+  <input name="text_input" type="text" value="text input" /><br/>
+  <input name="url_input" type="url" value="http://seleniumhq.org/" /><br/>
+  <br/>
+  <input name="checkbox_input" type="checkbox" value="Checkbox" checked /><br/>
+  <input name="radio_input" type="radio" value="radio1" checked /><br/>
+  <input name="radio_input" type="radio" value="radio2" /><br/>
+  <br/>
+  <input name="color_input" type="color" value="#00ffff" /><br/>
+  <br/>
+  <input name="date_input" type="date" value="2017-11-22" /><br/>
+  <input name="datetime_input" type="datetime" value="2017-11-22T11:22" /><br/>
+  <input name="datetime_local_input" type="datetime-local" value="2017-11-22T11:22" /><br/>
+  <input name="time_input" type="time" value="11:22" /><br/>
+  <input name="month_input" type="month" value="2017-11" /><br/>
+  <input name="week_input" type="week" value="2017-W47" /><br/>
+  <br/>
+  <input name="button_input" type="button" value="button" />&nbsp;
+  <input name="image_input" type="image" value="image" src="icon.gif" />&nbsp;
+  <input name="reset_input" type="reset" value="reset" />&nbsp;
+  <input name="submit_input" type="submit" value="submit" />&nbsp;
+
+  <input name="hidden_input" type="hidden" value="hidden" />
+</form>
+</body>
+</html>

package/lib/test/data/selectPage.html

@@ -54,5 +54,17 @@
     <option value="cheddar">Avonlea Clothbound Cheddar</option>
   </select>
 
+  <select id="visibility">
+    <option value="regular" class="regular">Regular</option>
+    <option value="disabled" disabled="disabled" class="disabled">Disabled</option>
+    <option value="hidden" style="visibility: hidden;" class="hidden">Hidden</option>
+    <option value="invisible" style="display: none;" class="invisible">Invisible</option>
+  </select>
+
+  <select id="transparent" style="opacity: 0;">
+    <option value="one">one</option>
+    <option value="two">two</option>
+  </select>
+
 </body>
 </html>

package/lib/test/data/simpleTest.html

@@ -94,5 +94,10 @@ document.write(" and with document.write again");
 
 <span id="trimmedSpace">             ​‌‍  ⁠　test             ​‌‍  ⁠　</span>
 
+<br/>
+<a id="capitalized" style="text-transform: capitalize">Hello, world! bla-bla-BLA</a><br/>
+<a id="lowercased" style="text-transform: lowercase">Hello, world! bla-bla-BLA</a><br/>
+<a id="uppercased" style="text-transform: uppercase">Hello, world! bla-bla-BLA</a><br/>
+
 </body>
 </html>

package/lib/test/data/upload_invisible.html

@@ -0,0 +1,45 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Upload Form</title>
+  <script>
+    var intervalId;
+    function onTick() {
+      var label = document.getElementById('upload_label');
+      label.innerHTML += '.';
+    }
+
+    function onUploadSubmit() {
+      document.getElementById('upload_target').contentWindow.document.body.
+          innerHTML = '';
+      var label = document.getElementById('upload_label');
+      label.innerHTML = 'Uploading "' + document.forms[0].upload.value + '"';
+      label.style.display = '';
+      intervalId = window.setInterval(onTick, 500);
+      return true;
+    }
+
+    function onUploadDone() {
+      var label = document.getElementById('upload_label');
+      label.style.display = 'none';
+      window.clearInterval(intervalId);
+      return true;
+    }
+  </script>
+</head>
+<body>
+<form action="/common/upload" method="post" name="upload_form"
+      target="upload_target" enctype="multipart/form-data"
+      onsubmit="onUploadSubmit();">
+  <div style='height: 0; width: 0; overflow: hidden;'>
+    <div><input id="upload" name="upload" type="file"/></div>
+  </div>
+  <label id="visible_label" for="upload">Upload</label>
+  <div><input id="go" type="submit" value="Go!"/></div>
+  <div id="upload_label" style="display:none"></div>
+  <iframe src="" id="upload_target" name="upload_target"
+          style="width:300px;height:200px">
+  </iframe>
+</form>
+</body>
+</html>

package/lib/test/fileserver.js

@@ -17,26 +17,28 @@
 
 'use strict';
 
-var fs = require('fs'),
-    http = require('http'),
-    path = require('path'),
-    url = require('url');
+const fs = require('fs');
+const http = require('http');
+const path = require('path');
+const url = require('url');
 
-var express = require('express');
-var multer = require('multer');
-var serveIndex = require('serve-index');
+const express = require('express');
+const multer = require('multer');
+const serveIndex = require('serve-index');
 
-var Server = require('./httpserver').Server,
-    resources = require('./resources'),
-    isDevMode = require('../devmode');
+const isDevMode = require('../devmode');
+const resources = require('./resources');
+const {Server} = require('./httpserver');
 
-var WEB_ROOT = '/common';
-var JS_ROOT = '/javascript';
+const WEB_ROOT = '/common';
+const DATA_ROOT = '/data';
+const JS_ROOT = '/javascript';
 
-var baseDirectory = resources.locate(isDevMode ? 'common/src/web' : '.');
-var jsDirectory = resources.locate(isDevMode ? 'javascript' : '..');
+const baseDirectory = resources.locate(isDevMode ? 'common/src/web' : '.');
+const dataDirectory = path.join(__dirname, 'data');
+const jsDirectory = resources.locate(isDevMode ? 'javascript' : '..');
 
-var Pages = (function() {
+const Pages = (function() {
   var pages = {};
   function addPage(page, path) {
     pages.__defineGetter__(page, function() {
@@ -105,7 +107,7 @@ var Pages = (function() {
 })();
 
 
-var Path = {
+const Path = {
   BASIC_AUTH: WEB_ROOT + '/basicAuth',
   ECHO: WEB_ROOT + '/echo',
   GENERATED: WEB_ROOT + '/generated',
@@ -126,6 +128,7 @@ app.get('/', sendIndex)
 .use(JS_ROOT, serveIndex(jsDirectory), express.static(jsDirectory))
 .post(Path.UPLOAD, handleUpload)
 .use(WEB_ROOT, serveIndex(baseDirectory), express.static(baseDirectory))
+.use(DATA_ROOT, serveIndex(dataDirectory), express.static(dataDirectory))
 .get(Path.ECHO, sendEcho)
 .get(Path.PAGE, sendInifinitePage)
 .get(Path.PAGE + '/*', sendInifinitePage)
@@ -250,7 +253,8 @@ function sendIndex(request, response) {
   }
 
   var data = ['<!DOCTYPE html><h1>/</h1><hr/><ul>',
-              createListEntry('common')];
+              createListEntry('common'),
+              createListEntry('data')];
   if (isDevMode) {
     data.push(createListEntry('javascript'));
   }
@@ -305,9 +309,9 @@ exports.url = server.url.bind(server);
 exports.whereIs = function(filePath) {
   filePath = filePath.replace(/\\/g, '/');
   if (!filePath.startsWith('/')) {
-    filePath = '/' + filePath;
+    filePath = `${WEB_ROOT}/${filePath}`;
   }
-  return server.url(WEB_ROOT + filePath);
+  return server.url(filePath);
 };