selenium-webdriver 3.3.0 → 4.0.0-alpha.1

package/test/logging_test.js

@@ -17,64 +17,58 @@
 
 'use strict';
 
-var Browser = require('..').Browser,
-    By = require('..').By,
-    logging = require('..').logging,
-    assert = require('../testing/assert'),
-    test = require('../lib/test');
+const assert = require('assert');
+
+const test = require('../lib/test');
+const {Browser, By, logging} = require('..');
 
 test.suite(function(env) {
-  // Logging API has numerous issues with PhantomJS:
-  //   - does not support adjusting log levels for type "browser".
-  //   - does not return proper log level for "browser" messages.
-  //   - does not delete logs after retrieval
   // Logging API is not supported in IE.
   // Logging API not supported in Marionette.
   // Tests depend on opening data URLs, which is broken in Safari (issue 7586)
-  test.ignore(env.browsers(
-      Browser.PHANTOM_JS, Browser.IE, Browser.SAFARI, Browser.FIREFOX)).
+  test.ignore(env.browsers(Browser.IE, Browser.SAFARI, Browser.FIREFOX)).
   describe('logging', function() {
     var driver;
 
-    test.beforeEach(function() {
+    beforeEach(function() {
       driver = null;
     });
 
-    test.afterEach(function*() {
+    afterEach(async function() {
       if (driver) {
         return driver.quit();
       }
     });
 
-    test.it('can be disabled', function*() {
+    it('can be disabled', async function() {
       var prefs = new logging.Preferences();
       prefs.setLevel(logging.Type.BROWSER, logging.Level.OFF);
 
-      driver = yield env.builder()
+      driver = await env.builder()
           .setLoggingPrefs(prefs)
           .build();
 
-      yield driver.get(dataUrl(
+      await driver.get(dataUrl(
           '<!DOCTYPE html><script>',
           'console.info("hello");',
           'console.warn("this is a warning");',
           'console.error("and this is an error");',
           '</script>'));
       return driver.manage().logs().get(logging.Type.BROWSER)
-          .then(entries => assert(entries.length).equalTo(0));
+          .then(entries => assert.equal(entries.length, 0));
     });
 
     // Firefox does not capture JS error console log messages.
     test.ignore(env.browsers(Browser.FIREFOX, 'legacy-firefox')).
-    it('can be turned down', function*() {
+    it('can be turned down', async function() {
       var prefs = new logging.Preferences();
       prefs.setLevel(logging.Type.BROWSER, logging.Level.SEVERE);
 
-      driver = yield env.builder()
+      driver = await env.builder()
           .setLoggingPrefs(prefs)
           .build();
 
-      yield driver.get(dataUrl(
+      await driver.get(dataUrl(
           '<!DOCTYPE html><script>',
           'console.info("hello");',
           'console.warn("this is a warning");',
@@ -82,23 +76,23 @@ test.suite(function(env) {
           '</script>'));
       return driver.manage().logs().get(logging.Type.BROWSER)
           .then(function(entries) {
-            assert(entries.length).equalTo(1);
-            assert(entries[0].level.name).equalTo('SEVERE');
-            assert(entries[0].message).matches(/.*\"?and this is an error\"?/);
+            assert.equal(entries.length, 1);
+            assert.equal(entries[0].level.name, 'SEVERE');
+            assert.ok(/.*\"?and this is an error\"?/.test(entries[0].message));
           });
     });
 
     // Firefox does not capture JS error console log messages.
     test.ignore(env.browsers(Browser.FIREFOX, 'legacy-firefox')).
-    it('can be made verbose', function*() {
+    it('can be made verbose', async function() {
       var prefs = new logging.Preferences();
       prefs.setLevel(logging.Type.BROWSER, logging.Level.DEBUG);
 
-      driver = yield env.builder()
+      driver = await env.builder()
           .setLoggingPrefs(prefs)
           .build();
 
-      yield driver.get(dataUrl(
+      await driver.get(dataUrl(
           '<!DOCTYPE html><script>',
           'console.debug("hello");',
           'console.warn("this is a warning");',
@@ -106,57 +100,57 @@ test.suite(function(env) {
           '</script>'));
       return driver.manage().logs().get(logging.Type.BROWSER)
           .then(function(entries) {
-            assert(entries.length).equalTo(3);
-            assert(entries[0].level.name).equalTo('DEBUG');
-            assert(entries[0].message).matches(/.*\"?hello\"?/);
+            assert.equal(entries.length, 3);
+            assert.equal(entries[0].level.name, 'DEBUG');
+            assert.ok(/.*\"?hello\"?/.test(entries[0].message));
 
-            assert(entries[1].level.name).equalTo('WARNING');
-            assert(entries[1].message).matches(/.*\"?this is a warning\"?/);
+            assert.equal(entries[1].level.name, 'WARNING');
+            assert.ok(/.*\"?this is a warning\"?/.test(entries[1].message));
 
-            assert(entries[2].level.name).equalTo('SEVERE');
-            assert(entries[2].message).matches(/.*\"?and this is an error\"?/);
+            assert.equal(entries[2].level.name, 'SEVERE');
+            assert.ok(/.*\"?and this is an error\"?/.test(entries[2].message));
           });
     });
 
     // Firefox does not capture JS error console log messages.
     test.ignore(env.browsers(Browser.FIREFOX, 'legacy-firefox')).
-    it('clears records after retrieval', function*() {
+    it('clears records after retrieval', async function() {
       var prefs = new logging.Preferences();
       prefs.setLevel(logging.Type.BROWSER, logging.Level.DEBUG);
 
-      driver = yield env.builder()
+      driver = await env.builder()
           .setLoggingPrefs(prefs)
           .build();
 
-      yield driver.get(dataUrl(
+      await driver.get(dataUrl(
           '<!DOCTYPE html><script>',
           'console.debug("hello");',
           'console.warn("this is a warning");',
           'console.error("and this is an error");',
           '</script>'));
-      yield driver.manage().logs().get(logging.Type.BROWSER)
-          .then(entries => assert(entries.length).equalTo(3));
+      await driver.manage().logs().get(logging.Type.BROWSER)
+          .then(entries => assert.equal(entries.length, 3));
       return driver.manage().logs().get(logging.Type.BROWSER)
-          .then(entries => assert(entries.length).equalTo(0));
+          .then(entries => assert.equal(entries.length, 0));
     });
 
-    test.it('does not mix log types', function*() {
+    it('does not mix log types', async function() {
       var prefs = new logging.Preferences();
       prefs.setLevel(logging.Type.BROWSER, logging.Level.DEBUG);
       prefs.setLevel(logging.Type.DRIVER, logging.Level.SEVERE);
 
-      driver = yield env.builder()
+      driver = await env.builder()
           .setLoggingPrefs(prefs)
           .build();
 
-      yield driver.get(dataUrl(
+      await driver.get(dataUrl(
           '<!DOCTYPE html><script>',
           'console.debug("hello");',
           'console.warn("this is a warning");',
           'console.error("and this is an error");',
           '</script>'));
       return driver.manage().logs().get(logging.Type.DRIVER)
-          .then(entries => assert(entries.length).equalTo(0));
+          .then(entries => assert.equal(entries.length, 0));
     });
   });
 

package/test/page_loading_test.js

@@ -17,147 +17,131 @@
 
 'use strict';
 
-var Browser = require('..').Browser,
-    By = require('..').By,
-    until = require('..').until,
-    assert = require('../testing/assert'),
-    error = require('../lib/error'),
-    test = require('../lib/test'),
-    Pages = test.Pages;
+const assert = require('assert');
+
+const error = require('../lib/error');
+const test = require('../lib/test');
+const {Browser, By, until} = require('..');
+
+const Pages = test.Pages;
 
 
 test.suite(function(env) {
-  var browsers = env.browsers;
+  var browsers = (...args) => env.browsers(...args);
 
   var driver;
-  test.before(function*() {
-    driver = yield env.builder().build();
+  before(async function() {
+    driver = await env.builder().build();
   });
 
-  test.beforeEach(function*() {
+  beforeEach(async function() {
     if (!driver) {
-      driver = yield env.builder().build();
+      driver = await env.builder().build();
     }
   });
 
-  test.after(function() {
+  after(function() {
     if (driver) {
       return driver.quit();
     }
   });
 
-  test.it('should wait for document to be loaded', function*() {
-    yield driver.get(Pages.simpleTestPage);
-    return assert(driver.getTitle()).equalTo('Hello WebDriver');
+  it('should wait for document to be loaded', async function() {
+    await driver.get(Pages.simpleTestPage);
+    assert.equal(await driver.getTitle(), 'Hello WebDriver');
   });
 
-  test.it('should follow redirects sent in the http response headers',
-      function*() {
-    yield driver.get(Pages.redirectPage);
-    return assert(driver.getTitle()).equalTo('We Arrive Here');
+  it('should follow redirects sent in the http response headers',
+      async function() {
+    await driver.get(Pages.redirectPage);
+    assert.equal(await driver.getTitle(), 'We Arrive Here');
   });
 
-  test.ignore(browsers(Browser.SAFARI)).
-  it('should follow meta redirects', function*() {
-    yield driver.get(Pages.metaRedirectPage);
-    return assert(driver.getTitle()).equalTo('We Arrive Here');
+  it('should be able to get a fragment on the current page', async function() {
+    await driver.get(Pages.xhtmlTestPage);
+    await driver.get(Pages.xhtmlTestPage + '#text');
+    await driver.findElement(By.id('id1'));
   });
 
-  // Skip Firefox; see https://bugzilla.mozilla.org/show_bug.cgi?id=1280300
-  test.ignore(browsers(Browser.FIREFOX)).
-  it('should be able to get a fragment on the current page', function*() {
-    yield driver.get(Pages.xhtmlTestPage);
-    yield driver.get(Pages.xhtmlTestPage + '#text');
-    yield driver.findElement(By.id('id1'));
-  });
+  it('should wait for all frames to load in a frameset', async function() {
+    await driver.get(Pages.framesetPage);
+    await driver.switchTo().frame(0);
 
-  test.ignore(browsers(Browser.IPAD, Browser.IPHONE)).
-  it('should wait for all frames to load in a frameset', function*() {
-    yield driver.get(Pages.framesetPage);
-    yield driver.switchTo().frame(0);
+    let txt = await driver.findElement(By.css('span#pageNumber')).getText();
+    assert.equal(txt.trim(), '1');
 
-    let txt = yield driver.findElement(By.css('span#pageNumber')).getText();
-    assert(txt.trim()).equalTo('1');
+    await driver.switchTo().defaultContent();
+    await driver.switchTo().frame(1);
+    txt = await driver.findElement(By.css('span#pageNumber')).getText();
 
-    yield driver.switchTo().defaultContent();
-    yield driver.switchTo().frame(1);
-    txt = yield driver.findElement(By.css('span#pageNumber')).getText();
+    assert.equal(txt.trim(), '2');
 
-    assert(txt.trim()).equalTo('2');
+    // For safari, need to make sure browser is focused on the main frame or
+    // subsequent tests will fail.
+    if (env.browser.name === Browser.SAFARI) {
+      await driver.switchTo().defaultContent();
+    }
   });
 
-  test.ignore(browsers(Browser.SAFARI)).
-  it('should be able to navigate back in browser history', function*() {
-    yield driver.get(Pages.formPage);
+  it('should be able to navigate back in browser history', async function() {
+    await driver.get(Pages.formPage);
 
-    yield driver.findElement(By.id('imageButton')).click();
-    yield driver.wait(until.titleIs('We Arrive Here'), 2500);
+    await driver.findElement(By.id('imageButton')).click();
+    await driver.wait(until.titleIs('We Arrive Here'), 2500);
 
-    yield driver.navigate().back();
-    yield driver.wait(until.titleIs('We Leave From Here'), 2500);
+    await driver.navigate().back();
+    await driver.wait(until.titleIs('We Leave From Here'), 2500);
   });
 
-  test.ignore(browsers(Browser.SAFARI)).
-  it('should be able to navigate back in presence of iframes', function*() {
-    yield driver.get(Pages.xhtmlTestPage);
+  it('should be able to navigate back in presence of iframes', async function() {
+    await driver.get(Pages.xhtmlTestPage);
 
-    yield driver.findElement(By.name('sameWindow')).click();
-    yield driver.wait(until.titleIs('This page has iframes'), 2500);
+    await driver.findElement(By.name('sameWindow')).click();
+    await driver.wait(until.titleIs('This page has iframes'), 2500);
 
-    yield driver.navigate().back();
-    yield driver.wait(until.titleIs('XHTML Test Page'), 2500);
+    await driver.navigate().back();
+    await driver.wait(until.titleIs('XHTML Test Page'), 2500);
   });
 
-  test.ignore(browsers(Browser.SAFARI)).
-  it('should be able to navigate forwards in browser history', function*() {
-    yield driver.get(Pages.formPage);
+  it('should be able to navigate forwards in browser history', async function() {
+    await driver.get(Pages.formPage);
 
-    yield driver.findElement(By.id('imageButton')).click();
-    yield driver.wait(until.titleIs('We Arrive Here'), 5000);
+    await driver.findElement(By.id('imageButton')).click();
+    await driver.wait(until.titleIs('We Arrive Here'), 5000);
 
-    yield driver.navigate().back();
-    yield driver.wait(until.titleIs('We Leave From Here'), 5000);
+    await driver.navigate().back();
+    await driver.wait(until.titleIs('We Leave From Here'), 5000);
 
-    yield driver.navigate().forward();
-    yield driver.wait(until.titleIs('We Arrive Here'), 5000);
+    await driver.navigate().forward();
+    await driver.wait(until.titleIs('We Arrive Here'), 5000);
   });
 
-  // PhantomJS 2.0 does not properly reload pages on refresh.
-  test.ignore(browsers(Browser.PHANTOM_JS)).
-  it('should be able to refresh a page', function*() {
-    yield driver.get(Pages.xhtmlTestPage);
+  it('should be able to refresh a page', async function() {
+    await driver.get(Pages.xhtmlTestPage);
 
-    yield driver.navigate().refresh();
+    await driver.navigate().refresh();
 
-    yield assert(driver.getTitle()).equalTo('XHTML Test Page');
+    assert.equal(await driver.getTitle(), 'XHTML Test Page');
   });
 
-  test.it('should return title of page if set', function*() {
-    yield driver.get(Pages.xhtmlTestPage);
-    yield assert(driver.getTitle()).equalTo('XHTML Test Page');
+  it('should return title of page if set', async function() {
+    await driver.get(Pages.xhtmlTestPage);
+    assert.equal(await driver.getTitle(), 'XHTML Test Page');
 
-    yield driver.get(Pages.simpleTestPage);
-    yield assert(driver.getTitle()).equalTo('Hello WebDriver');
+    await driver.get(Pages.simpleTestPage);
+    assert.equal(await driver.getTitle(), 'Hello WebDriver');
   });
 
   describe('timeouts', function() {
-    test.afterEach(function() {
+    afterEach(function() {
       let nullDriver = () => driver = null;
       if (driver) {
         return driver.quit().then(nullDriver, nullDriver);
       }
     });
 
-    // Only implemented in Firefox.
-    test.ignore(browsers(
-        Browser.CHROME,
-        Browser.IE,
-        Browser.IPAD,
-        Browser.IPHONE,
-        Browser.OPERA,
-        Browser.PHANTOM_JS)).
-    it('should timeout if page load timeout is set', function*() {
-      yield driver.manage().timeouts().pageLoadTimeout(1);
+    it('should timeout if page load timeout is set', async function() {
+      await driver.manage().setTimeouts({pageLoad: 1});
       return driver.get(Pages.sleepingPage + '?time=3')
           .then(function() {
             throw Error('Should have timed out on page load');

package/test/proxy_test.js

@@ -17,17 +17,17 @@
 
 'use strict';
 
-var http = require('http'),
-    url = require('url');
-
-var Browser = require('..').Browser,
-    promise = require('..').promise,
-    firefox = require('../firefox'),
-    proxy = require('../proxy'),
-    assert = require('../testing/assert'),
-    test = require('../lib/test'),
-    Server = require('../lib/test/httpserver').Server,
-    Pages = test.Pages;
+const assert = require('assert');
+const http = require('http');
+const url = require('url');
+
+const firefox = require('../firefox');
+const proxy = require('../proxy');
+const test = require('../lib/test');
+const {Browser} = require('..');
+const {Server} = require('../lib/test/httpserver');
+
+const Pages = test.Pages;
 
 test.suite(function(env) {
   function writeResponse(res, body, encoding, contentType) {
@@ -86,69 +86,64 @@ test.suite(function(env) {
     };
   }
 
-  test.before(mkStartFunc(proxyServer));
-  test.before(mkStartFunc(helloServer));
-  test.before(mkStartFunc(goodbyeServer));
+  before(mkStartFunc(proxyServer));
+  before(mkStartFunc(helloServer));
+  before(mkStartFunc(goodbyeServer));
 
-  test.after(proxyServer.stop.bind(proxyServer));
-  test.after(helloServer.stop.bind(helloServer));
-  test.after(goodbyeServer.stop.bind(goodbyeServer));
+  after(proxyServer.stop.bind(proxyServer));
+  after(helloServer.stop.bind(helloServer));
+  after(goodbyeServer.stop.bind(goodbyeServer));
 
   var driver;
-  test.beforeEach(function() { driver = null; });
-  test.afterEach(function() { return driver && driver.quit(); });
+  beforeEach(function() { driver = null; });
+  afterEach(function() { return driver && driver.quit(); });
 
   function createDriver(proxy) {
-    // For Firefox we need to explicitly enable proxies for localhost by
-    // clearing the network.proxy.no_proxies_on preference.
-    let profile = new firefox.Profile();
-    profile.setPreference('network.proxy.no_proxies_on', '');
-
     return driver = env.builder()
-        .setFirefoxOptions(new firefox.Options().setProfile(profile))
+        // For Firefox we need to explicitly enable proxies for localhost by
+        // clearing the network.proxy.no_proxies_on preference.
+        .setFirefoxOptions(
+            new firefox.Options()
+                .setBinary(firefox.Channel.AURORA)
+                .setPreference('network.proxy.no_proxies_on', ''))
         .setProxy(proxy)
         .build();
   }
 
   // Proxy support not implemented.
-  test.ignore(env.browsers(Browser.IE, Browser.OPERA, Browser.SAFARI)).
+  test.ignore(env.browsers(Browser.IE, Browser.SAFARI)).
   describe('manual proxy settings', function() {
-    // phantomjs 1.9.1 in webdriver mode does not appear to respect proxy
-    // settings.
-    test.ignore(env.browsers(Browser.PHANTOM_JS)).
-    it('can configure HTTP proxy host', function*() {
-      yield createDriver(proxy.manual({
+    it('can configure HTTP proxy host', async function() {
+      await createDriver(proxy.manual({
         http: proxyServer.host()
       }));
 
-      yield driver.get(helloServer.url());
-      yield assert(driver.getTitle()).equalTo('Proxy page');
-      yield assert(driver.findElement({tagName: 'h3'}).getText()).
-          equalTo('This is the proxy landing page');
+      await driver.get(helloServer.url());
+      assert.equal(await driver.getTitle(), 'Proxy page');
+      assert.equal(
+          await driver.findElement({tagName: 'h3'}).getText(),
+          'This is the proxy landing page');
     });
 
-    // PhantomJS does not support bypassing the proxy for individual hosts.
-    // geckodriver does not support the bypass option, this must be configured
-    // through profile preferences.
-    test.ignore(env.browsers(
-        Browser.FIREFOX,
-        'legacy-' + Browser.FIREFOX,
-        Browser.PHANTOM_JS)).
-    it('can bypass proxy for specific hosts', function*() {
-      yield createDriver(proxy.manual({
+    it('can bypass proxy for specific hosts', async function() {
+      await createDriver(proxy.manual({
         http: proxyServer.host(),
-        bypass: helloServer.host()
+        bypass: [helloServer.host()]
       }));
 
-      yield driver.get(helloServer.url());
-      yield assert(driver.getTitle()).equalTo('Hello');
-      yield assert(driver.findElement({tagName: 'h3'}).getText()).
-          equalTo('Hello, world!');
-
-      yield driver.get(goodbyeServer.url());
-      yield assert(driver.getTitle()).equalTo('Proxy page');
-      yield assert(driver.findElement({tagName: 'h3'}).getText()).
-          equalTo('This is the proxy landing page');
+      await driver.get(helloServer.url());
+      assert.equal(await driver.getTitle(), 'Hello');
+      assert.equal(
+          await driver.findElement({tagName: 'h3'}).getText(),
+          'Hello, world!');
+
+      // For firefox the no proxy settings appear to match on hostname only.
+      let url = goodbyeServer.url().replace(/127\.0\.0\.1/, 'localhost');
+      await driver.get(url);
+      assert.equal(await driver.getTitle(), 'Proxy page');
+      assert.equal(
+          await driver.findElement({tagName: 'h3'}).getText(),
+          'This is the proxy landing page');
     });
 
     // TODO: test ftp and https proxies.
@@ -156,25 +151,22 @@ test.suite(function(env) {
 
   // PhantomJS does not support PAC file proxy configuration.
   // Safari does not support proxies.
-  test.ignore(env.browsers(
-      Browser.IE, Browser.OPERA, Browser.PHANTOM_JS, Browser.SAFARI)).
+  test.ignore(env.browsers(Browser.IE, Browser.SAFARI)).
   describe('pac proxy settings', function() {
-    test.it('can configure proxy through PAC file', function*() {
-      yield createDriver(proxy.pac(proxyServer.url('/proxy.pac')));
-
-      yield driver.get(helloServer.url());
-      yield assert(driver.getTitle()).equalTo('Proxy page');
-      yield assert(driver.findElement({tagName: 'h3'}).getText()).
-          equalTo('This is the proxy landing page');
-
-      yield driver.get(goodbyeServer.url());
-      yield assert(driver.getTitle()).equalTo('Goodbye');
-      yield assert(driver.findElement({tagName: 'h3'}).getText()).
-          equalTo('Goodbye, world!');
+    it('can configure proxy through PAC file', async function() {
+      await createDriver(proxy.pac(proxyServer.url('/proxy.pac')));
+
+      await driver.get(helloServer.url());
+      assert.equal(await driver.getTitle(), 'Proxy page');
+      assert.equal(
+          await driver.findElement({tagName: 'h3'}).getText(),
+          'This is the proxy landing page');
+
+      await driver.get(goodbyeServer.url());
+      assert.equal(await driver.getTitle(), 'Goodbye');
+      assert.equal(
+          await driver.findElement({tagName: 'h3'}).getText(),
+          'Goodbye, world!');
     });
   });
-
-  // TODO: figure out how to test direct and system proxy settings.
-  describe.skip('direct proxy settings', function() {});
-  describe.skip('system proxy settings', function() {});
 });

package/test/rect_test.js

@@ -23,38 +23,27 @@ const {By} = require('..');
 const test = require('../lib/test');
 
 test.suite(function(env) {
-  describe('rect commands', function() {
+  describe('WebElement', function() {
     let driver;
-    let el;
 
-    test.before(function*() {
-      driver = yield env.builder().build();
-      yield driver.get(
-            'data:text/html,<!DOCTYPE html><style>'
-                + '*{padding:0; margin:0}'
-                + 'div{position: absolute; top: 50px; left: 50px;'
-                + 'height: 50px;width:50px;background: green;}'
-                + '</style><div>Hello</div>');
-      el = yield driver.findElement(By.css('div'));
+    before(async function() {
+      driver = await env.builder().build();
     });
 
     after(function() {
-      if (driver) {
-        return driver.quit();
-      }
-    });
-
-    test.it('WebElement.getLocation()', function*() {
-      let location = yield el.getLocation();
-      assert.equal(location.x, 50);
-      assert.equal(location.y, 50);
+      return driver.quit();
     });
 
-    test.it('WebElement.getSize()', function*() {
-      let size = yield el.getSize();
-      assert.equal(size.width, 50);
-      assert.equal(size.height, 50);
+    it('getRect()', async function() {
+      await driver.get(
+            'data:text/html,<!DOCTYPE html><style>'
+                + '*{padding:0; margin:0}'
+                + 'div{position: absolute; top: 50px; left: 40px;'
+                + 'height: 25px;width:35px;background: green;}'
+                + '</style><div>Hello</div>');
+      const el = await driver.findElement(By.css('div'));
+      const rect = await el.getRect();
+      assert.deepEqual(rect, {width: 35, height: 25, x: 40, y: 50});
     });
-
   });
 });