selenium-webdriver 2.47.0 → 2.52.0

package/lib/session.js

@@ -0,0 +1,79 @@
+// 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('./capabilities').Capabilities;
+
+
+/**
+ * Contains information about a single WebDriver session.
+ */
+class Session {
+
+  /**
+   * @param {string} id The session ID.
+   * @param {!(Object|Capabilities)} capabilities The session
+   *     capabilities.
+   */
+  constructor(id, capabilities) {
+    /** @private {string} */
+    this.id_ = id;
+
+    /** @private {!Capabilities} */
+    this.caps_ = capabilities instanceof Capabilities
+        ? /** @type {!Capabilities} */(capabilities)
+        : new Capabilities(capabilities);
+  }
+
+  /**
+   * @return {string} This session's ID.
+   */
+  getId() {
+    return this.id_;
+  }
+
+  /**
+   * @return {!Capabilities} This session's capabilities.
+   */
+  getCapabilities() {
+    return this.caps_;
+  }
+
+  /**
+   * Retrieves the value of a specific capability.
+   * @param {string} key The capability to retrieve.
+   * @return {*} The capability value.
+   */
+  getCapability(key) {
+    return this.caps_.get(key);
+  }
+
+  /**
+   * Returns the JSON representation of this object, which is just the string
+   * session ID.
+   * @return {string} The JSON representation of this Session.
+   */
+  toJSON() {
+    return this.getId();
+  }
+}
+
+
+// PUBLIC API
+
+exports.Session = Session;

package/{test/promise_aplus_test.js → lib/symbols.js}

@@ -17,30 +17,20 @@
 
 'use strict';
 
-describe('Promises/A+ Compliance Tests', function() {
-  var promise = require('../_base').require('webdriver.promise');
+/**
+ * @fileoverview Defines well-known symbols used within the selenium-webdriver
+ * library.
+ */
 
-  var nullFunction = function() {};
 
-  before(function() {
-    promise.controlFlow().on('uncaughtException', nullFunction);
-  });
-
-  after(function() {
-    promise.controlFlow().removeListener('uncaughtException', nullFunction);
-  });
-
-  require('promises-aplus-tests').mocha({
-    resolved: promise.fulfilled,
-    rejected: promise.rejected,
-    deferred: function() {
-      var d = promise.defer();
-      return {
-        resolve: d.fulfill,
-        reject: d.reject,
-        promise: d.promise
-      };
-    }
-  });
-
-});
+/**
+ * The serialize symbol specifies a method that returns an object's serialized
+ * representation. If an object's serialized form is not immediately available,
+ * the serialize method will return a promise that will be resolved with the
+ * serialized form.
+ *
+ * Note that the described method is analgous to objects that define a
+ * `toJSON()` method, except the serialized result may be a promise, or another
+ * object with a promised property.
+ */
+exports.serialize = Symbol('serialize');

package/lib/test/build.js

@@ -17,18 +17,18 @@
 
 'use strict';
 
-var spawn = require('child_process').spawn,
+const spawn = require('child_process').spawn,
     fs = require('fs'),
     path = require('path');
 
-var promise = require('../..').promise,
-    base = require('../../_base');
+const isDevMode = require('../devmode'),
+    promise = require('../promise');
 
 var projectRoot = path.normalize(path.join(__dirname, '../../../../..'));
 
 
 function checkIsDevMode() {
-  if (!base.isDevMode()) {
+  if (!isDevMode) {
     throw Error('Cannot execute build; not running in dev mode');
   }
 }

package/lib/test/data/click_tests/disappearing_element.html

@@ -0,0 +1,62 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <title>An element that disappears on click</title>
+  <style>
+#under {
+  position: absolute;
+  top: 20;
+  left: 20;
+  width: 100px;
+  height: 100px;
+  background-color: white;
+}
+
+#over {
+  position: absolute;
+  top: 20;
+  left: 20;
+  width: 100px;
+  height: 100px;
+  background-color: red;
+  opacity: 0.5;
+}
+
+#log {
+  position: absolute;
+  top: 120px;
+}
+  </style>
+</head>
+<body id="body">
+  <div id="under"><p id="contents">Hello</p></div>
+  <div id="over"></div>
+  <div id="log">
+    <p>Log:<p>
+  </div>
+<script>
+var byId = document.getElementById.bind(document);
+
+var log = byId("log");
+
+function handler(ev) {
+  log.innerHTML += "<p></p>";
+  log.lastElementChild.textContent = ev.type + " in " + ev.target.id + " (handled by " + ev.currentTarget.id + ")\n";
+}
+
+var under = byId("under");
+var over = byId("over");
+var body = document.body;
+
+var types = ["click", "mousedown", "mouseup"];
+for (var i = 0, type; (type = types[i]); ++i) {
+  under.addEventListener(type, handler);
+  over.addEventListener(type, handler);
+  body.addEventListener(type, handler);
+}
+over.addEventListener("mousedown", function () {
+  over.style.display = "none";
+})
+</script>
+</body>
+</html>

package/lib/test/data/click_tests/html5_submit_buttons.html

@@ -8,8 +8,9 @@
 <label for="name">Enter your name: </label><input type="text" name="name" id="name"/>
 <button id="internal_explicit_submit" type="submit">Explicit Submit</button>
 <button id="internal_implicit_submit">Implicit Submit</button>
+<button type="submit"><span id="internal_span_submit">Spanned Submit</span></button>
 </form>
 <button id="external_explicit_submit" type="submit" form="form1">Explicit Submit</button>
 <button id="external_implicit_submit" form="form1">Implicit Submit</button>
 </body>
-</html>
+</html>

package/lib/test/data/click_tests/overlapping_elements.html

@@ -0,0 +1,70 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <title>An element that disappears on click</title>
+  <style>
+#under {
+  position: absolute;
+  top: 20px;
+  left: 20px;
+  width: 100px;
+  height: 100px;
+  background-color: white;
+}
+
+#partially_under {
+  position: absolute;
+  top: 20px;
+  left: 10px;
+  width: 100px;
+  height: 100px;
+  background-color: blue;
+  opacity: 0.5;
+}
+
+#over {
+  position: absolute;
+  top: 20px;
+  left: 20px;
+  width: 100px;
+  height: 100px;
+  background-color: red;
+  opacity: 0.5;
+}
+
+#log {
+  position: absolute;
+  top: 120px;
+}
+  </style>
+</head>
+<body id="body">
+  <div id="under"><p id="contents">Hello</p></div>
+  <div id="partially_under"><p id="other_contents">Hello</p></div>
+  <div id="over"></div>
+  <div id="log">
+    <p>Log:<p>
+  </div>
+<script>
+var byId = document.getElementById.bind(document);
+
+var log = byId("log");
+
+function handler(ev) {
+  log.innerHTML += "<p></p>";
+  log.lastElementChild.textContent = ev.type + " in " + ev.target.id + " (handled by " + ev.currentTarget.id + ")\n";
+}
+
+var under = byId("under");
+var over = byId("over");
+var body = document.body;
+
+var types = ["click", "mousedown", "mouseup"];
+for (var i = 0, type; (type = types[i]); ++i) {
+  under.addEventListener(type, handler);
+  over.addEventListener(type, handler);
+  body.addEventListener(type, handler);
+}
+</script>
+</body>
+</html>

package/lib/test/data/click_tests/partially_overlapping_elements.html

@@ -0,0 +1,124 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <title>An element that disappears on click</title>
+  <style>
+#under_under {
+  position: absolute;
+  top: 20px;
+  left: 20px;
+  width: 100px;
+  height: 100px;
+  background-color: white;
+}
+
+#under {
+  position: absolute;
+  top: 20px;
+  left: 20px;
+  width: 100px;
+  height: 100px;
+  background-color: blue;
+  opacity: 0.1;
+}
+
+#over1 {
+  position: absolute;
+  top: 10px;
+  left: 10px;
+  width: 50px;
+  height: 50px;
+  background-color: red;
+  opacity: 0.2;
+}
+
+#over2 {
+  position: absolute;
+  top: 80px;
+  left: 10px;
+  width: 50px;
+  height: 50px;
+  background-color: red;
+  opacity: 0.2;
+}
+
+#over3 {
+  position: absolute;
+  top: 10px;
+  left: 80px;
+  width: 50px;
+  height: 50px;
+  background-color: red;
+  opacity: 0.2;
+}
+
+#over4 {
+  position: absolute;
+  top: 80px;
+  left: 80px;
+  width: 50px;
+  height: 50px;
+  background-color: red;
+  opacity: 0.2;
+}
+
+#over5 {
+  position: absolute;
+  top: 45px;
+  left: 45px;
+  width: 50px;
+  height: 50px;
+  background-color: red;
+  opacity: 0.2;
+}
+
+#log {
+  position: absolute;
+  top: 120px;
+}
+  </style>
+</head>
+<body id="body">
+  <div id="under_under"><p id="contents">Hello</p></div>
+  <div id="under"><p id="other_contents">Hello</p></div>
+  <div id="over1"></div>
+  <div id="over2"></div>
+  <div id="over3"></div>
+  <div id="over4"></div>
+  <div id="over5"></div>
+  <div id="log">
+    <p>Log:<p>
+  </div>
+<script>
+var byId = document.getElementById.bind(document);
+
+var log = byId("log");
+
+function handler(ev) {
+  log.innerHTML += "<p></p>";
+  log.lastElementChild.textContent = ev.type + " in " + ev.target.id + " (handled by " + ev.currentTarget.id + ")\n";
+}
+
+var under_under = byId("under_under");
+var under = byId("under");
+var over1 = byId("over1");
+var over2 = byId("over2");
+var over3 = byId("over3");
+var over4 = byId("over4");
+var over5 = byId("over5");
+var body = document.body;
+
+var types = ["click", "mousedown", "mouseup"];
+for (var i = 0, type; (type = types[i]); ++i) {
+  under_under.addEventListener(type, handler);
+  under.addEventListener(type, handler);
+  over1.addEventListener(type, handler);
+  over2.addEventListener(type, handler);
+  over3.addEventListener(type, handler);
+  over4.addEventListener(type, handler);
+  over5.addEventListener(type, handler);
+  body.addEventListener(type, handler);
+}
+</script>
+</body>
+</html>

package/lib/test/data/click_tests/wrapped_overlapping_elements.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+  <title>A wrapped element with overlapped first part</title>
+</head>
+<body id="body">
+<div style="width:300px">
+  <div style="float:left;width:200px;background:green;">placeholder</div>
+  <div style="float:left; position:absolute;width:100px;margin-left:200px;background:red;opacity:0.5;">Over</div>
+  <a id="link" href="submitted_page.html">Link that continues on next line</a>
+</div>
+</body>
+</html>

package/lib/test/data/readOnlyPage.html

@@ -16,7 +16,9 @@ text area which is not supposed to be cleared</textarea>
 <textarea rows="5" id="textAreaNotenabled" disabled="true" cols="20">
 text area which is not supposed to be cleared</textarea>
 
-<div id="content-editable" contentEditable="true">This is a contentEditable area</div>
+<div id="content-editable" contentEditable="true"><h1>This</h1><h2>is a</h2><p>contentEditable area</p></div>
+
+<div id="content-editable-blank" contentEditable="true" style="height:50px;"></div>
 </body>
 </html>
 

package/lib/test/data/selectPage.html

@@ -9,7 +9,7 @@
     <option value="one">one</option>
     <option value="two" />two</option>
   </select>
-  
+
   <select id="selectWithMultipleEqualsMultiple" multiple="multiple">
     <option selected="selected" label="emmental">Emmental</option>
     <option label="roquefort">Roquefort</option>
@@ -26,7 +26,7 @@
     <option value="one">one</option>
     <option value="two">two</option>
   </select>
-  
+
   <select id="selectWithRandomMultipleValue" multiple="somethingElse">
     <option value="one">one</option>
     <option value="two">two</option>
@@ -38,5 +38,21 @@
       <option id="two-in-group" value="two">two</option>
     </optgroup>
   </select>
+
+  <select id="selectWithMultipleLongList" multiple>
+    <option>one</option>
+    <option>two</option>
+    <option>three</option>
+    <option>four</option>
+    <option>five</option>
+    <option>six</option>
+  </select>
+
+  <select id="narrow" style="width: 50px;">
+    <option value="evalon">LaClare Farms Evalon with Cummin</option>
+    <option value="savourine">Yarra Valley Vintage Savourine</option>
+    <option value="cheddar">Avonlea Clothbound Cheddar</option>
+  </select>
+
 </body>
 </html>

package/lib/test/data/simpleTest.html

@@ -6,6 +6,7 @@
 <h1>Heading</h1>
 
 <p id="oneline">A single line of text</p>
+<p id="hiddenline" style="visibility: hidden">A hidden line of text</p>
 
 <div id="multiline">
     <p>A div containing</p>

package/lib/test/fileserver.js

@@ -28,9 +28,8 @@ var serveIndex = require('serve-index');
 
 var Server = require('./httpserver').Server,
     resources = require('./resources'),
-    promise = require('../..').promise,
-    isDevMode = require('../../_base').isDevMode(),
-    string = require('../../_base').require('goog.string');
+    isDevMode = require('../devmode'),
+    promise = require('../promise');
 
 var WEB_ROOT = '/common';
 var JS_ROOT = '/javascript';
@@ -303,7 +302,7 @@ exports.url = server.url.bind(server);
  */
 exports.whereIs = function(filePath) {
   filePath = filePath.replace(/\\/g, '/');
-  if (!string.startsWith(filePath, '/')) {
+  if (!filePath.startsWith('/')) {
     filePath = '/' + filePath;
   }
   return server.url(WEB_ROOT + filePath);

package/lib/test/index.js

@@ -20,9 +20,9 @@
 var assert = require('assert');
 
 var build = require('./build'),
-    webdriver = require('../..'),
+    isDevMode = require('../devmode'),
+    webdriver = require('../../'),
     flow = webdriver.promise.controlFlow(),
-    _base = require('../../_base'),
     remote = require('../../remote'),
     testing = require('../../testing'),
     fileserver = require('./fileserver');
@@ -34,6 +34,7 @@ var build = require('./build'),
  */
 var NATIVE_BROWSERS = [
   webdriver.Browser.CHROME,
+  webdriver.Browser.EDGE,
   webdriver.Browser.FIREFOX,
   webdriver.Browser.IE,
   webdriver.Browser.OPERA,
@@ -44,6 +45,7 @@ var NATIVE_BROWSERS = [
 
 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;
 
@@ -58,6 +60,9 @@ var browsersToTest = (function() {
     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) {
@@ -91,6 +96,9 @@ var browsersToTest = (function() {
     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')
+    }
   }
 
   return browsers;
@@ -190,7 +198,7 @@ function suite(fn, opt_options) {
     browsers.forEach(function(browser) {
       testing.describe('[' + browser + ']', function() {
 
-        if (_base.isDevMode() && nativeRun) {
+        if (isDevMode && nativeRun) {
           if (browser === webdriver.Browser.FIREFOX) {
             testing.before(function() {
               return build.of('//javascript/firefox-driver:webdriver')
@@ -208,7 +216,8 @@ function suite(fn, opt_options) {
 
         if (!!serverJar && !remoteUrl) {
           if (!(serverToUse = seleniumServer)) {
-            serverToUse = seleniumServer = new remote.SeleniumServer(serverJar);
+            serverToUse = seleniumServer = new remote.SeleniumServer(
+                serverJar, {loopback: useLoopback});
           }
 
           testing.before(function() {

package/lib/test/resources.js

@@ -20,7 +20,7 @@
 var fs = require('fs'),
     path = require('path');
 
-var resourceRoot = require('../../_base').isDevMode() ?
+var resourceRoot = require('../devmode') ?
     require('./build').projectRoot() :
     path.join(__dirname, 'data');