selenium-webdriver 2.48.2 → 2.53.3

package/lib/session.js

@@ -0,0 +1,80 @@
+// 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
+
+
+module.exports = {Session: Session};

package/lib/{webdriver/serializable.js → symbols.js}

@@ -15,27 +15,24 @@
 // specific language governing permissions and limitations
 // under the License.
 
-goog.provide('webdriver.Serializable');
-
-
+'use strict';
 
 /**
- * Defines an object that can be asynchronously serialized to its WebDriver
- * wire representation.
- *
- * @constructor
- * @template T
+ * @fileoverview Defines well-known symbols used within the selenium-webdriver
+ * library.
  */
-webdriver.Serializable = function() {};
 
 
-/**
- * Returns either this instance's serialized represention, if immediately
- * available, or a promise for its serialized representation. This function is
- * conceptually equivalent to objects that have a {@code toJSON()} property,
- * except the serialize() result may be a promise or an object containing a
- * promise (which are not directly JSON friendly).
- *
- * @return {!(T|IThenable.<!T>)} This instance's serialized wire format.
- */
-webdriver.Serializable.prototype.serialize = goog.abstractMethod;
+module.exports = {
+  /**
+   * 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.
+   */
+  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/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

@@ -5,17 +5,27 @@
   <style>
 #under {
   position: absolute;
-  top: 20;
-  left: 20;
+  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: 20;
-  left: 20;
+  top: 20px;
+  left: 20px;
   width: 100px;
   height: 100px;
   background-color: red;
@@ -30,6 +40,7 @@
 </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>

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

@@ -0,0 +1,45 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title></title>
+    <script type="text/javascript">
+      var next = 0;
+
+      function addVisibleBox() {
+        var box = document.createElement('DIV');
+        box.id = 'box' + next++;
+        box.className = 'redbox';
+        box.style.width = '150px';
+        box.style.height = '150px';
+        box.style.backgroundColor = 'red';
+        box.style.border = '1px solid black';
+        box.style.margin = '5px';
+        box.style.visibility = 'visible'
+
+        window.setTimeout(function() {
+          document.body.appendChild(box);
+        }, 1000);
+      }
+
+      function addHiddenBox() {
+        var box = document.createElement('DIV');
+        box.id = 'box' + next++;
+        box.className = 'redbox';
+        box.style.width = '150px';
+        box.style.height = '150px';
+        box.style.backgroundColor = 'red';
+        box.style.border = '1px solid black';
+        box.style.margin = '5px';
+        box.style.visibility = 'hidden';
+
+        window.setTimeout(function() {
+          document.body.appendChild(box);
+        }, 1000);
+      }
+    </script>
+  </head>
+  <body>
+    <input id="addVisible" type="button" value="Add a visible box!" onclick="addVisibleBox()"/>
+    <input id="addHidden" type="button" value="Add a hidden box!" onclick="addHiddenBox();" />
+  </body>
+</html>

package/lib/test/data/readOnlyPage.html

@@ -16,7 +16,7 @@ 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>

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/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,
@@ -59,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) {
@@ -194,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')

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');