selenium-webdriver 3.3.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/click_tests/disabled_element.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Clicking on a disabled element</title>
+</head>
+<body>
+<h1>See below</h1>
+<form action="POST">
+  <input name="disabled" disabled="disabled" />
+</form>
+</body>
+</html>

package/lib/test/data/content-editable.html

@@ -0,0 +1,10 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Testing content editable</title>
+</head>
+<body>
+  <div id="editable" contenteditable="true">
+    Why <span>hello</span></div>
+</body>
+</html>

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/key_logger.html

@@ -0,0 +1,34 @@
+<?xml version="1.0"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+    <title>Testing Key Events</title>
+    <script type="text/javascript">
+        function appendMessage(message) {
+            document.getElementById('resultParagraph').innerHTML += message + " ";
+        }
+    </script>
+</head>
+<body>
+<div id="resultContainer" height="30">&nbsp;
+  <div id="result" style="width:300;height:60">
+    <p id="resultParagraph">&nbsp;</p>
+  </div>
+</div>
+                                                                                         
+<div>
+  <form action="resultPage.html" id="on-form">
+    <input id="theworks"
+           onfocus="appendMessage('focus')"
+           onkeydown="appendMessage('keydown')"
+           onkeypress="appendMessage('keypress')"
+           onkeyup="appendMessage('keyup')"
+           onblur="appendMessage('blur')"
+           onchange="appendMessage('change')"
+           />
+  </form>
+</div>
+</body>
+</html>
+
+

package/lib/test/data/nestedElements.html

@@ -5,6 +5,15 @@
   <div id="test_id_div">
   	<p id="test_id">inside</p>
   </div>
+  <div id="test_special_chars">
+    <p id="white space">space</p>
+    <p id="css#.chars">css escapes</p>
+  </div>
+  <div id="test_special_chars_2">
+    <p id="white space">second copy for testing plural findElements</p>
+    <p id="css#.chars">second copy</p>
+  </div>
+
 <form method="get" action="resultPage.html" name="form1" style="display: block">
     Here's a checkbox: <input type="checkbox" id="checky" name="checky" value="furrfu"/><br/>
     <select name="selectomatic" id="1">
@@ -152,4 +161,4 @@
   <span class="oneother">But not me</span>
 </div>
 </body>
-</html>
+</html>

package/lib/test/data/scrolling_tests/page_with_partially_hidden_element.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Page with partially hidden element</title>
+</head>
+<body>
+  <div style="width:200px; height: 200px; overflow: auto;">
+    <div style="height: 175px; width: 240px;">Placeholder</div>
+    <div>
+      <button type="button" style="height: 40px; box-sizing: border-box" id="btn" onclick="window.location='target_page.html'">Click me!</button>
+    </div>
+  </div>
+</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/single_text_input.html

@@ -0,0 +1,12 @@
+<html>
+<head>
+    <title>BasicKeyboardInterfaceTest</title>
+</head>
+<body>
+<form action="#">
+    <input type="text" id="textInput" />
+</form>
+</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>