selenium-webdriver 4.0.0-alpha.3 → 4.0.0-alpha.7

package/lib/webdriver.js

@@ -42,6 +42,7 @@ const W3C_CAPABILITY_NAMES = new Set([
     'proxy',
     'setWindowRect',
     'timeouts',
+    'strictFileInteractability',
     'unhandledPromptBehavior',
 ]);
 
@@ -1110,7 +1111,7 @@ class Options {
    *     invalid.
    * @throws {TypeError} if `spec` is not a cookie object.
    */
-  addCookie({name, value, path, domain, secure, httpOnly, expiry}) {
+  addCookie({name, value, path, domain, secure, httpOnly, expiry, sameSite}) {
     // We do not allow '=' or ';' in the name.
     if (/[;=]/.test(name)) {
       throw new error.InvalidArgumentError(
@@ -1130,6 +1131,11 @@ class Options {
       expiry = Math.floor(date.getTime() / 1000);
     }
 
+    if(sameSite && sameSite !== 'Strict' && sameSite !== 'Lax') {
+      throw new error.InvalidArgumentError(
+          `Invalid sameSite cookie value '${sameSite}'. It should be either "Lax" (or) "Strict" `);
+    }
+
     return this.driver_.execute(
         new command.Command(command.Name.ADD_COOKIE).
             setParameter('cookie', {
@@ -1139,7 +1145,8 @@ class Options {
               'domain': domain,
               'secure': !!secure,
               'httpOnly': !!httpOnly,
-              'expiry': expiry
+              'expiry': expiry,
+              'sameSite': sameSite
             }));
   }
 
@@ -1187,7 +1194,8 @@ class Options {
    *
    * @param {string} name The name of the cookie to retrieve.
    * @return {!Promise<?Options.Cookie>} A promise that will be resolved
-   *     with the named cookie, or `null` if there is no such cookie.
+   *     with the named cookie
+   * @throws {error.NoSuchCookieError} if there is no such cookie.
    */
   async getCookie(name) {
     try {
@@ -1397,6 +1405,17 @@ Options.Cookie.prototype.httpOnly;
 Options.Cookie.prototype.expiry;
 
 
+/**
+ * When the cookie applies to a SameSite policy.
+ *
+ * When {@linkplain Options#addCookie() adding a cookie}, this may be specified
+ * as a {@link string} object which is either 'Lax' or 'Strict'.
+ *
+ *
+ * @type {(!Date|number|undefined)}
+ */
+Options.Cookie.prototype.sameSite;
+
 /**
  * An interface for managing the current window.
  *
@@ -2099,6 +2118,17 @@ class WebElement {
             setParameter('name', attributeName));
   }
 
+  /**
+   * Get the given property of the referenced web element
+   * @param {string} propertyName The name of the attribute to query.
+   * @return {!Promise<string>} A promise that will be
+   *     resolved with the element's property value
+   */
+  getProperty(propertyName) {
+    return this.execute_(
+        new command.Command(command.Name.GET_ELEMENT_PROPERTY).setParameter('name', propertyName));
+  }
+
   /**
    * Get the visible (i.e. not hidden by CSS) innerText of this element,
    * including sub-elements, without any leading or trailing whitespace.

package/net/portprober.js

@@ -149,7 +149,7 @@ async function findWindowsPortRange() {
 function isFree(port, opt_host) {
   return new Promise((resolve, reject) => {
     let server = net.createServer().on('error', function(e) {
-      if (e.code === 'EADDRINUSE') {
+      if (e.code === 'EADDRINUSE' || e.code === 'EACCES') {
         resolve(false);
       } else {
         reject(e);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "selenium-webdriver",
-  "version": "4.0.0-alpha.3",
+  "version": "4.0.0-alpha.7",
   "description": "The official WebDriver JavaScript bindings from the Selenium project",
   "license": "Apache-2.0",
   "keywords": [
@@ -23,18 +23,17 @@
     "node": ">= 10.15.0"
   },
   "dependencies": {
-    "jszip": "^3.1.5",
-    "rimraf": "^2.6.3",
-    "tmp": "0.0.30",
-    "xml2js": "^0.4.19"
+    "jszip": "^3.2.2",
+    "rimraf": "^2.7.1",
+    "tmp": "0.0.30"
   },
   "devDependencies": {
-    "express": "^4.16.4",
-    "jasmine": "^3.3.1",
+    "express": "^4.17.1",
+    "jasmine": "^3.5.0",
     "mocha": "^5.2.0",
-    "multer": "^1.4.1",
+    "multer": "^1.4.2",
     "serve-index": "^1.9.1",
-    "sinon": "^7.2.3"
+    "sinon": "^7.5.0"
   },
   "scripts": {
     "test": "mocha -t 600000 --recursive test",

package/BUILD.bazel

@@ -1,88 +0,0 @@
-load("@build_bazel_rules_nodejs//:defs.bzl", "nodejs_binary", "npm_package")
-load("@npm_bazel_jasmine//:index.bzl", "jasmine_node_test")
-
-SRC_FILES = [
-    "CHANGES.md",
-    "README.md",
-    "package.json",
-] + glob([
-    "*.js",
-    "example/*.js",
-    "http/*.js",
-    "io/*.js",
-    "lib/*.js",
-    "net/*.js",
-    "remote/*.js",
-    "testing/*.js",
-])
-
-npm_package(
-    name = "selenium-webdriver",
-    srcs = SRC_FILES,
-    deps = [
-        ":license",
-        "//javascript/node/selenium-webdriver/lib/atoms:get_attribute",
-        "//javascript/node/selenium-webdriver/lib/atoms:is_displayed",
-    ],
-)
-
-TEST_FILES = glob(["test/**/*_test.js"])
-
-TEST_DATA = SRC_FILES + glob(
-    [
-        "lib/test/**",
-        "test/**",
-    ],
-    exclude = TEST_FILES,
-)
-
-nodejs_binary(
-    name = "fileserver",
-    data = TEST_DATA + [
-        "//common/src/web",
-        "@npm//express",
-        "@npm//multer",
-        "@npm//serve-index",
-        "@npm//tmp",
-        "@npm//jszip",
-        "@npm//rimraf",
-        "//javascript/node/selenium-webdriver/lib/atoms:get_attribute",
-        "//javascript/node/selenium-webdriver/lib/atoms:is_displayed",
-    ],
-    entry_point = "selenium/javascript/node/selenium-webdriver/lib/test/fileserver.js",
-)
-
-jasmine_node_test(
-    name = "tests",
-    srcs = TEST_FILES,
-    bootstrap = ["selenium/javascript/node/selenium-webdriver/tools/init_jasmine.js"],
-    data = TEST_DATA + [
-        "tools/init_jasmine.js",
-        "//common/src/web",
-        "@npm//express",
-        "@npm//multer",
-        "@npm//serve-index",
-        "@npm//jszip",
-        "@npm//rimraf",
-        "@npm//tmp",
-        "@npm//sinon",
-        "@npm//xml2js",
-    ],
-    local = True,
-    deps = [
-        "//javascript/node/selenium-webdriver/lib/atoms:get_attribute",
-        "//javascript/node/selenium-webdriver/lib/atoms:is_displayed",
-        "@npm//jasmine",
-    ],
-)
-
-# npm_package does not pick up filegroup sources.
-genrule(
-    name = "license",
-    srcs = ["//:license"],
-    outs = [
-        "LICENSE",
-        "NOTICE",
-    ],
-    cmd = "cp $(locations //:license) $(@D)",
-)

package/example/chrome_android.js

@@ -1,42 +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.
-
-/**
- * @fileoverview A basic example of working with Chrome on Android. Before
- * running this example, you must start adb and connect a device (or start an
- * AVD).
- */
-
-'use strict';
-
-const {Builder, By, Key, until} = require('..');
-const {Options} = require('../chrome');
-
-(async function() {
-  let driver;
-  try {
-    driver = await new Builder()
-        .forBrowser('chrome')
-        .setChromeOptions(new Options().androidChrome())
-        .build();
-    await driver.get('http://www.google.com/ncr');
-    await driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN);
-    await driver.wait(until.titleIs('webdriver - Google Search'), 1000);
-  } finally {
-    await driver && driver.quit();
-  }
-})().then(_ => console.log('SUCCESS'), err => console.error('ERROR: ' + err));

package/example/chrome_mobile_emulation.js

@@ -1,42 +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.
-
-/**
- * @fileoverview This is an example of emulating a mobile device using the
- * ChromeDriver.
- */
-
-'use strict';
-
-const {Builder, By, Key, until} = require('..');
-const {Options} = require('../chrome');
-
-(async function() {
-  let driver;
-  try {
-    driver = await new Builder()
-        .forBrowser('chrome')
-        .setChromeOptions(
-            new Options().setMobileEmulation({deviceName: 'Nexus 5X'}))
-        .build();
-    await driver.get('http://www.google.com/ncr');
-    await driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN);
-    await driver.wait(until.titleIs('webdriver - Google Search'), 1000);
-  } finally {
-    await driver && driver.quit();
-  }
-})().then(_ => console.log('SUCCESS'), err => console.error('ERROR: ' + err));

package/example/firefox_channels.js

@@ -1,77 +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.
-
-/**
- * @fileoverview This is an example of working with the different Firefox
- * release channels. Before running this example, you will need to have
- * installed Firefox's release, nightly, and developer editions:
- *
- * - https://www.mozilla.org/en-US/firefox/channel/desktop/#aurora
- * - https://www.mozilla.org/en-US/firefox/channel/desktop/#nightly
- */
-
-
-'use strict';
-
-const {Builder, By, Key, promise, until} = require('..');
-const {Channel, Options} = require('../firefox');
-
-let i = 0;
-function resposition(driver) {
-  return driver.manage().window().setRect({
-    width: 600,
-    height: 400,
-    x: 300 * (i++),
-    y: 0
-  });
-}
-
-async function doSearch(driver) {
-  try {
-    // Start on the base about page.
-    await driver.get('about:')
-    // Reposition so users can see the three windows.
-    await resposition(driver);
-    // Pause so users can see the magic.
-    await promise.delayed(750);
-    // Now do the rest.
-    await driver.get('http://www.google.com/ncr');
-    await driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN);
-    await driver.wait(until.titleIs('webdriver - Google Search'), 1000);
-    console.log('Success!');
-  } catch (ex) {
-    console.log('An error occured! ' + ex);
-  } finally {
-    await driver.quit();
-  }
-}
-
-function createDriver(channel) {
-  let options = new Options().setBinary(channel);
-  return new Builder().forBrowser('firefox').setFirefoxOptions(options).build();
-}
-
-Promise.all([
-  doSearch(createDriver(Channel.RELEASE)),
-  doSearch(createDriver(Channel.AURORA)),  // Developer Edition.
-  doSearch(createDriver(Channel.NIGHTLY)),
-]).then(_ => {
-  console.log('All done!');
-}, err => {
-  console.error('An error occured! ' + err);
-  setTimeout(() => {throw err}, 0);
-});

package/example/google_search.js

@@ -1,50 +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.
-
-/**
- * @fileoverview An example WebDriver script.
- *
- * Before running this script, ensure that Mozilla's geckodriver is present on
- * your system PATH: <https://github.com/mozilla/geckodriver/releases>
- *
- * Usage:
- *   // Default behavior
- *   node selenium-webdriver/example/google_search.js
- *
- *   // Target Chrome locally; the chromedriver must be on your PATH
- *   SELENIUM_BROWSER=chrome node selenium-webdriver/example/google_search.js
- *
- *   // Use a local copy of the standalone Selenium server
- *   SELENIUM_SERVER_JAR=/path/to/selenium-server-standalone.jar \
- *     node selenium-webdriver/example/google_search.js
- *
- *   // Target a remote Selenium server
- *   SELENIUM_REMOTE_URL=http://www.example.com:4444/wd/hub \
- *     node selenium-webdriver/example/google_search.js
- */
-
-const {Builder, By, Key, until} = require('..');
-
-var driver = new Builder()
-    .forBrowser('firefox')
-    .build();
-
-driver.get('http://www.google.com/ncr')
-    .then(_ =>
-        driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN))
-    .then(_ => driver.wait(until.titleIs('webdriver - Google Search'), 1000))
-    .then(_ => driver.quit());

package/example/google_search_test.js

@@ -1,72 +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.
-
-/**
- * @fileoverview An example test that may be run using Mocha.
- *
- * This example uses the `selenium-webdriver/testing.suite` function, which will
- * automatically run tests against every available WebDriver browser on the
- * current system. Alternatively, you may use the `SELENIUM_BROWSER`
- * environment variable to narrow the scope at runtime.
- *
- * Usage:
- *
- *     # Automatically determine which browsers to run against.
- *     mocha -t 10000 selenium-webdriver/example/google_search_test.js
- *
- *     # Configure tests to only run against Google Chrome.
- *     SELENIUM_BROWSER=chrome \
- *         mocha -t 10000 selenium-webdriver/example/google_search_test.js
- */
-
-const assert = require('assert');
-
-const {Browser, By, Key, until} = require('..');
-const {ignore, suite} = require('../testing');
-
-suite(function(env) {
-  describe('Google Search', function() {
-    let driver;
-
-    before(async function() {
-      // env.builder() returns a Builder instance preconfigured for the
-      // envrionment's target browser (you may still define browser specific
-      // options if necessary (i.e. firefox.Options or chrome.Options)).
-      driver = await env.builder().build();
-    });
-
-    it('demo', async function() {
-      await driver.get('https://www.google.com/ncr');
-      await driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN);
-      await driver.wait(until.titleIs('webdriver - Google Search'), 1000);
-    });
-
-    // The ignore function returns wrappers around describe & it that will
-    // suppress tests if the provided predicate returns true. You may provide
-    // any synchronous predicate. The env.browsers(...) function generates a
-    // predicate that will suppress tests if the  env targets one of the
-    // specified browsers.
-    //
-    // This example is always configured to skip Chrome.
-    ignore(env.browsers(Browser.CHROME)).it('demo 2', async function() {
-      await driver.get('https://www.google.com/ncr');
-      await driver.wait(until.urlIs('https://www.google.com/'), 1500);
-    });
-
-    after(() => driver && driver.quit());
-  });
-});

package/example/headless.js

@@ -1,55 +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.
-
-/**
- * @fileoverview An example of running Chrome or Firefox in headless mode.
- *
- * To run with Chrome, ensure you have Chrome 59+ installed and that
- * chromedriver 2.30+ is present on your system PATH:
- * <https://sites.google.com/a/chromium.org/chromedriver/downloads>
- *
- *     SELENIUM_BROWSER=chrome node selenium-webdriver/example/headless.js
- *
- * To run with Firefox, ensure you have Firefox 57+ installed and that
- * geckodriver 0.19.0+ is present on your system PATH:
- * <https://github.com/mozilla/geckodriver/releases>
- *
- *     SELENIUM_BROWSER=firefox node selenium-webdriver/example/headless.js
- */
-
-const chrome = require('../chrome');
-const firefox = require('../firefox');
-const {Builder, By, Key, until} = require('..');
-
-const width = 640;
-const height = 480;
-
-let driver = new Builder()
-    .forBrowser('chrome')
-    .setChromeOptions(
-        new chrome.Options().headless().windowSize({width, height}))
-    .setFirefoxOptions(
-        new firefox.Options().headless().windowSize({width, height}))
-    .build();
-
-driver.get('http://www.google.com/ncr')
-    .then(_ =>
-        driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN))
-    .then(_ => driver.wait(until.titleIs('webdriver - Google Search'), 1000))
-    .then(
-        _ => driver.quit(),
-        e => driver.quit().then(() => { throw e; }));

package/example/logging.js

@@ -1,68 +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.
-
-/**
- * @fileoverview Demonstrates how to use WebDriver's logging sysem.
- */
-
-'use strict';
-
-const chrome = require('../chrome');
-const firefox = require('../firefox');
-const edge = require('../edge');
-const {Builder, By, Key, logging, until} = require('..');
-
-logging.installConsoleHandler();
-logging.getLogger('webdriver.http').setLevel(logging.Level.ALL);
-
-(async function() {
-  let driver;
-  try {
-    driver = await new Builder()
-        // Default to using Firefox. This can be overridden at runtime by
-        // setting the SELENIUM_BROWSER environment variable:
-        //
-        //   SELENIUM_BROWSER=chrome node selenium-webdriver/example/logging.js
-        .forBrowser('firefox')
-        // Configure the service for each browser to enable verbose logging and
-        // to inherit the stdio settings from the current process. The builder
-        // will only start the service if needed for the selected browser.
-        .setChromeService(
-            new chrome.ServiceBuilder()
-                .enableVerboseLogging()
-                .setStdio('inherit'))
-        .setEdgeService(
-            process.platform === 'win32'
-                ? new edge.ServiceBuilder()
-                    .enableVerboseLogging()
-                    .setStdio('inherit')
-                : null)
-        .setFirefoxService(
-            new firefox.ServiceBuilder()
-                .enableVerboseLogging()
-                .setStdio('inherit'))
-        .build();
-
-    await driver.get('http://www.google.com/ncr');
-    await driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN);
-    await driver.wait(until.titleIs('webdriver - Google Search'), 1000);
-  } finally {
-    if (driver) {
-      await driver.quit();
-    }
-  }
-})();

package/jasmine.json

@@ -1,11 +0,0 @@
-{
-  "spec_dir": "test",
-  "spec_files": [
-    "**/*_test.js"
-  ],
-  "helpers": [
-    "../lib/test/bootstrap_jasmine.js"
-  ],
-  "stopSpecOnExpectationFailure": false,
-  "random": false
-}

package/lib/atoms/BUILD.bazel

@@ -1,28 +0,0 @@
-load("@build_bazel_rules_nodejs//:defs.bzl", "nodejs_binary")
-
-nodejs_binary(
-    name = "make_atoms_module",
-    data = ["make-atoms-module.js"],
-    entry_point = "selenium/javascript/node/selenium-webdriver/lib/atoms/make-atoms-module",
-)
-
-# genrules used to copy closure_js_binary outputs to locations
-# that will be picked up by the npm_package rule.
-
-genrule(
-    name = "is_displayed",
-    srcs = ["//javascript/atoms/fragments:is-displayed.js"],
-    outs = ["is-displayed.js"],
-    cmd = "$(location :make_atoms_module) $< $@",
-    tools = [":make_atoms_module"],
-    visibility = ["//javascript/node/selenium-webdriver:__pkg__"],
-)
-
-genrule(
-    name = "get_attribute",
-    srcs = ["//javascript/webdriver/atoms:get-attribute.js"],
-    outs = ["get-attribute.js"],
-    cmd = "$(location :make_atoms_module) $< $@",
-    tools = [":make_atoms_module"],
-    visibility = ["//javascript/node/selenium-webdriver:__pkg__"],
-)