selenium-webdriver 2.48.2 → 2.53.3

package/test/page_loading_test.js

@@ -19,7 +19,7 @@
 
 var Browser = require('..').Browser,
     By = require('..').By,
-    ErrorCode = require('..').error.ErrorCode,
+    error = require('../error'),
     until = require('..').until,
     assert = require('../testing/assert'),
     test = require('../lib/test'),
@@ -81,10 +81,10 @@ test.suite(function(env) {
     driver.get(Pages.formPage);
 
     driver.findElement(By.id('imageButton')).click();
-    driver.wait(until.titleIs('We Arrive Here'), 5000);
+    driver.wait(until.titleIs('We Arrive Here'), 2500);
 
     driver.navigate().back();
-    assert(driver.getTitle()).equalTo('We Leave From Here');
+    driver.wait(until.titleIs('We Leave From Here'), 2500);
   });
 
   test.ignore(browsers(Browser.SAFARI)).
@@ -92,10 +92,10 @@ test.suite(function(env) {
     driver.get(Pages.xhtmlTestPage);
 
     driver.findElement(By.name('sameWindow')).click();
-    driver.wait(until.titleIs('This page has iframes'), 5000);
+    driver.wait(until.titleIs('This page has iframes'), 2500);
 
     driver.navigate().back();
-    assert(driver.getTitle()).equalTo('XHTML Test Page');
+    driver.wait(until.titleIs('XHTML Test Page'), 2500);
   });
 
   test.ignore(browsers(Browser.SAFARI)).
@@ -146,10 +146,8 @@ test.suite(function(env) {
           then(function() {
             throw Error('Should have timed out on page load');
           }, function(e) {
-            // The FirefoxDriver returns TIMEOUT directly, where as the
-            // java server returns SCRIPT_TIMEOUT (bug?).
-            if (e.code !== ErrorCode.SCRIPT_TIMEOUT &&
-                e.code !== ErrorCode.TIMEOUT) {
+            if (!(e instanceof error.ScriptTimeoutError)
+                && !(e instanceof error.TimeoutError)) {
               throw Error('Unexpected error response: ' + e);
             }
           });

package/test/remote_test.js

@@ -15,10 +15,16 @@
 // specific language governing permissions and limitations
 // under the License.
 
-var assert = require('assert');
+'use strict';
 
-var promise = require('../').promise;
-var remote = require('../remote');
+var assert = require('assert'),
+    fs = require('fs'),
+    path = require('path');
+
+var promise = require('../').promise,
+    io = require('../io'),
+    cmd = require('../lib/command'),
+    remote = require('../remote');
 
 describe('DriverService', function() {
   describe('start()', function() {
@@ -70,3 +76,44 @@ describe('DriverService', function() {
     }
   });
 });
+
+describe('FileDetector', function() {
+  class ExplodingDriver {
+    schedule() {
+      throw Error('unexpected call');
+    }
+  }
+
+  it('returns the original path if the file does not exist', function() {
+    return io.tmpDir(dir => {
+      let theFile = path.join(dir, 'not-there');
+      return (new remote.FileDetector)
+          .handleFile(new ExplodingDriver, theFile)
+          .then(f => assert.equal(f, theFile));
+    });
+  });
+
+  it('returns the original path if it is a directory', function() {
+    return io.tmpDir(dir => {
+      return (new remote.FileDetector)
+          .handleFile(new ExplodingDriver, dir)
+          .then(f => assert.equal(f, dir));
+    });
+  });
+
+  it('attempts to upload valid files', function() {
+    return io.tmpFile(theFile => {
+      return (new remote.FileDetector)
+          .handleFile(
+              new (class FakeDriver {
+                schedule(command) {
+                  assert.equal(command.getName(), cmd.Name.UPLOAD_FILE);
+                  assert.equal(typeof command.getParameters()['file'], 'string');
+                  return Promise.resolve('success!');
+                }
+              }),
+              theFile)
+          .then(f => assert.equal(f, 'success!'));
+    });
+  });
+});

package/test/session_test.js

@@ -0,0 +1,53 @@
+// 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';
+
+var WebDriver = require('..').WebDriver,
+    assert = require('../testing/assert'),
+    test = require('../lib/test'),
+    Pages = test.Pages;
+
+
+test.suite(function(env) {
+  var browsers = env.browsers;
+
+  var driver;
+  test.before(function() {
+    driver = env.builder().build();
+  });
+
+  test.after(function() {
+    driver.quit();
+  });
+
+  test.it('can connect to an existing session', function() {
+    driver.get(Pages.simpleTestPage);
+    assert(driver.getTitle()).equalTo('Hello WebDriver');
+
+    return driver.getSession().then(session1 => {
+      let driver2 = WebDriver.attachToSession(
+          driver.getExecutor(),
+          session1.getId());
+
+      assert(driver2.getTitle()).equalTo('Hello WebDriver');
+
+      let session2Id = driver2.getSession().then(s => s.getId());
+      assert(session2Id).equalTo(session1.getId());
+    });
+  });
+});

package/test/stale_element_test.js

@@ -52,7 +52,7 @@ test.suite(function(env) {
     var el = driver.findElement(By.id('oneline'));
     driver.switchTo().defaultContent();
     el.getText().then(fail, function(e) {
-      assert(e.code).equalTo(error.ErrorCode.STALE_ELEMENT_REFERENCE);
+      assert(e).instanceOf(error.StaleElementReferenceError);
     });
   });
-});
+});

package/test/testing/assert_test.js

@@ -0,0 +1,374 @@
+// 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 assert = require('../../testing/assert');
+
+const AssertionError = require('assert').AssertionError;
+const assertTrue = require('assert').ok;
+const assertEqual = require('assert').equal;
+const assertThrows = require('assert').throws;
+const fail = require('assert').fail;
+
+
+describe('assert', function() {
+  describe('atLeast', function() {
+    it('compares subject >= value', function() {
+      assert(1).atLeast(0);
+      assert(1).atLeast(1);
+      assertThrows(() => assert(1).atLeast(2));
+    });
+
+    it('accepts failure message', function() {
+      assertThrows(
+          () => assert(1).atLeast(2, 'hi there!'),
+          (error) => error.message.indexOf('hi there') != -1);
+    });
+
+    it('fails if given a non-numeric subject', function() {
+      assertThrows(() => assert('a').atLeast(1));
+    });
+
+    it('fails if given a non-numeric bound', function() {
+      assertThrows(() => assert(1).atLeast('a'));
+    });
+
+    it('waits for promised subject', function() {
+      return assert(Promise.resolve(123)).atLeast(100);
+    });
+
+    it('waits for promised subject (with failure)', function() {
+      return assert(Promise.resolve(100))
+          .atLeast(123)
+          .then(() => fail('should have failed'), function(e) {
+            assertInstanceOf(AssertionError, e);
+            assertEqual('100 >= 123', e.message);
+          });
+    });
+  });
+
+  describe('atMost', function() {
+    it('compares subject <= value', function() {
+      assertThrows(() => assert(1).atMost(0));
+      assert(1).atMost(1);
+      assert(1).atMost(2);
+    });
+
+    it('accepts failure message', function() {
+      assertThrows(
+          () => assert(1).atMost(0, 'hi there!'),
+          (error) => error.message.indexOf('hi there!') != -1);
+    });
+
+    it('fails if given a non-numeric subject', function() {
+      assertThrows(() => assert(1).atMost('a'));
+    });
+
+    it('fails if given a non-numeric bound', function() {
+      assertThrows(() => assert('a').atMost(1));
+    });
+
+    it('waits for promised subject', function() {
+      return assert(Promise.resolve(100)).atMost(123);
+    });
+
+    it('waits for promised subject (with failure)', function() {
+      return assert(Promise.resolve(123))
+          .atMost(100)
+          .then(() => fail('should have failed'), function(e) {
+            assertInstanceOf(AssertionError, e);
+            assertEqual('123 <= 100', e.message);
+          });
+    });
+  });
+
+  describe('greaterThan', function() {
+    it('compares subject > value', function() {
+      assertThrows(() => assert(1).greaterThan(1));
+      assertThrows(() => assert(1).greaterThan(2));
+      assert(2).greaterThan(1);
+    });
+
+    it('accepts failure message', function() {
+      assertThrows(
+          () => assert(0).greaterThan(1, 'hi there!'),
+          (error) => error.message.indexOf('hi there!') != -1);
+    });
+
+    it('fails if given a non-numeric subject', function() {
+      assertThrows(() => assert('a').atMost(1));
+    });
+
+    it('fails if given a non-numeric bound', function() {
+      assertThrows(() => assert(1).atMost('a'));
+    });
+
+    it('waits for promised subject', function() {
+      return assert(Promise.resolve(123)).greaterThan(100);
+    });
+
+    it('waits for promised subject (with failure)', function() {
+      return assert(Promise.resolve(100))
+          .greaterThan(123)
+          .then(() => fail('should have failed'), function(e) {
+            assertInstanceOf(AssertionError, e);
+            assertEqual('100 > 123', e.message);
+          });
+    });
+  });
+
+  describe('lessThan', function() {
+    it('compares subject < value', function() {
+      assertThrows(() => assert(1).lessThan(0));
+      assertThrows(() => assert(1).lessThan(1));
+      assert(1).lessThan(2);
+    });
+
+    it('accepts failure message', function() {
+      assertThrows(
+          () => assert(1).lessThan(0, 'hi there!'),
+          (error) => error.message.indexOf('hi there!') != -1);
+    });
+
+    it('fails if given a non-numeric subject', function() {
+      assertThrows(() => assert('a').lessThan(1));
+    });
+
+    it('fails if given a non-numeric bound', function() {
+      assertThrows(() => assert(1).lessThan('a'));
+    });
+
+    it('waits for promised subject', function() {
+      return assert(Promise.resolve(100)).lessThan(123);
+    });
+
+    it('waits for promised subject (with failure)', function() {
+      return assert(Promise.resolve(123))
+          .lessThan(100)
+          .then(() => fail('should have failed'), function(e) {
+            assertInstanceOf(AssertionError, e);
+            assertEqual('123 < 100', e.message);
+          });
+    });
+  });
+
+  describe('closeTo', function() {
+    it('accepts values within epislon of target', function() {
+      assert(123).closeTo(123, 0);
+      assert(123).closeTo(124, 1);
+      assert(125).closeTo(124, 1);
+
+      assertThrows(() => assert(123).closeTo(125, .1));
+      assertThrows(() => assert(1./3).closeTo(.8, .01));
+    });
+
+    it('waits for promised values', function() {
+      let d = Promise.defer();
+      setTimeout(() => d.resolve(123), 10);
+      return assert(d.promise).closeTo(124, 1);
+    });
+  });
+
+  describe('instanceOf', function() {
+    it('works with direct instances', function() {
+      assert(Error('foo')).instanceOf(Error);
+    });
+
+    it('works with sub-types', function() {
+      assert(TypeError('foo')).instanceOf(Error);
+    });
+
+    it('parent types are not instances of sub-types', function() {
+      assertThrows(() => assert(Error('foo')).instanceOf(TypeError));
+    });
+  });
+
+  describe('isNull', function() {
+    it('normal case', function() {
+      assert(null).isNull();
+      assertThrows(() => assert(1).isNull());
+    });
+
+    it('handles promised values', function() {
+      let p = new Promise(function(f) {
+        setTimeout(() => f(null), 10);
+      });
+      return assert(p).isNull();
+    });
+
+    it('does not match on undefined', function() {
+      assertThrows(() => assert(void(0)).isNull());
+    })
+  });
+
+  describe('isUndefined', function() {
+    it('normal case', function() {
+      assert(void(0)).isUndefined();
+      assertThrows(() => assert(1).isUndefined());
+    });
+
+    it('handles promised values', function() {
+      let p = new Promise(function(f) {
+        setTimeout(() => f(void(0)), 10);
+      });
+      return assert(p).isUndefined();
+    });
+
+    it('does not match on null', function() {
+      assertThrows(() => assert(null).isUndefined());
+    })
+  });
+
+  describe('contains', function() {
+    it('works with strings', function() {
+      assert('abc').contains('a');
+      assert('abc').contains('ab');
+      assert('abc').contains('abc');
+      assert('abc').contains('bc');
+      assert('abc').contains('c');
+      assertThrows(() => assert('abc').contains('d'));
+    });
+
+    it('works with arrays', function() {
+      assert([1, 2, 3]).contains(1);
+      assert([1, 2, 3]).contains(2);
+      assert([1, 2, 3]).contains(3);
+      assertThrows(() => assert([1, 2]).contains(3));
+    });
+
+    it('works with maps', function() {
+      let m = new Map;
+      m.set(1, 2);
+      assert(m).contains(1);
+      assertThrows(() => assert(m).contains(2));
+    });
+
+    it('works with sets', function() {
+      let s = new Set;
+      s.add(1);
+      assert(s).contains(1);
+      assertThrows(() => assert(s).contains(2));
+    });
+
+    it('requires an array, string, map, or set subject', function() {
+      assertThrows(() => assert(123).contains('a'));
+    });
+  });
+
+  describe('endsWith', function() {
+    it('works', function() {
+      assert('abc').endsWith('abc');
+      assert('abc').endsWith('bc');
+      assert('abc').endsWith('c');
+      assertThrows(() => assert('abc').endsWith('d'));
+    })
+  });
+
+  describe('startsWith', function() {
+    it('works', function() {
+      assert('abc').startsWith('abc');
+      assert('abc').startsWith('ab');
+      assert('abc').startsWith('a');
+      assertThrows(() => assert('abc').startsWith('d'));
+    })
+  });
+
+  describe('matches', function() {
+    it('requires a regex value', function() {
+      assertThrows(() => assert('abc').matches(1234));
+    });
+
+    it('requires a string value', function() {
+      assertThrows(() => assert(1234).matches(/abc/));
+    });
+
+    it('requires a string value (promise case)', function() {
+      return assert(Promise.resolve(1234))
+          .matches(/abc/)
+          .then(fail, function(error) {
+            assertEqual(
+                'Expected a string matching /abc/, got <1234> (number)',
+                error.message);
+          });
+    });
+
+    it('applies regex', function() {
+      assert('abc').matches(/abc/);
+      assertThrows(() => assert('def').matches(/abc/));
+    });
+  });
+
+  describe('isTrue', function() {
+    it('only accepts booleans', function() {
+      assertThrows(() => assert(123).isTrue());
+    });
+
+    it('accepts true values', function() {
+      assert(true).isTrue();
+      assert(Boolean('abc')).isTrue();
+      return assert(Promise.resolve(true)).isTrue();
+    });
+
+    it('rejects false values', function() {
+      assertThrows(() => assert(false).isTrue());
+      assertThrows(() => assert(Boolean(0)).isTrue());
+      return assert(Promise.resolve(false)).isTrue()
+          .then(fail, function() {/*no-op, ok*/});
+    });
+  });
+
+  describe('isFalse', function() {
+    it('only accepts booleans', function() {
+      assertThrows(() => assert(123).isFalse());
+    })
+
+    it('accepts false values', function() {
+      assert(false).isFalse();
+      assert(Boolean('')).isFalse();
+      return assert(Promise.resolve(false)).isFalse();
+    });
+
+    it('rejects true values', function() {
+      assertThrows(() => assert(true).isFalse());
+      assertThrows(() => assert(Boolean(1)).isFalse());
+      return assert(Promise.resolve(true)).isFalse()
+          .then(fail, function() {/*no-op, ok*/});
+    });
+  });
+
+  describe('isEqualTo', function() {
+    it('is strict equality', function() {
+      assert('abc').isEqualTo('abc');
+      assert('abc').equals('abc');
+      assert('abc').equalTo('abc');
+      assertThrows(() => assert('1').isEqualTo(1));
+    });
+  });
+
+  describe('notEqualTo', function() {
+    it('tests strict equality', function() {
+      assert('1').notEqualTo(1);
+      assert(1).notEqualTo('1');
+      assertThrows(() => assert('abc').notEqualTo('abc'));
+    });
+  });
+
+  function assertInstanceOf(ctor, value) {
+    assertTrue(value instanceof ctor);
+  }
+});

package/test/testing/index_test.js

@@ -48,8 +48,7 @@ describe('Mocha Integration', function() {
 
       beforeEach(function() {
         flowReset = false;
-        promise.controlFlow().once(
-            promise.ControlFlow.EventType.RESET, onreset);
+        test.controlFlow().once(promise.ControlFlow.EventType.RESET, onreset);
       });
 
       test.it('', function() {
@@ -59,7 +58,7 @@ describe('Mocha Integration', function() {
 
       afterEach(function() {
         assert.ok(!flowReset);
-        promise.controlFlow().removeListener(
+        test.controlFlow().removeListener(
             promise.ControlFlow.EventType.RESET, onreset);
       });
 
@@ -73,8 +72,7 @@ describe('Mocha Integration', function() {
 
       beforeEach(function() {
         flowReset = false;
-        promise.controlFlow().once(
-            promise.ControlFlow.EventType.RESET, onreset);
+        test.controlFlow().once(promise.ControlFlow.EventType.RESET, onreset);
       });
 
       test.it('', function() {
@@ -94,9 +92,11 @@ describe('Mocha Integration', function() {
       });
 
       afterEach(function() {
-        promise.controlFlow().removeListener(
-            promise.ControlFlow.EventType.RESET, onreset);
-        assert.ok(flowReset, 'control flow was not reset after a timeout');
+        return Promise.resolve().then(function() {
+          test.controlFlow().removeListener(
+              promise.ControlFlow.EventType.RESET, onreset);
+          assert.ok(flowReset, 'control flow was not reset after a timeout');
+        });
       });
 
       function onreset() {
@@ -137,8 +137,6 @@ describe('Mocha async "done" support', function() {
    test.it('delayed', function(done) {
       assert(done);
       assert.strictEqual(typeof done, 'function');
-      //console.log(done.name);
-      //console.log(done.toString());
       setTimeout(function delayedTimeoutCallback() {
          waited = true;
          done();
@@ -162,7 +160,7 @@ describe('ControlFlow and "done" work together', function() {
    var flow, order;
    before(function() {
       order = [];
-      flow = promise.controlFlow();
+      flow = test.controlFlow();
       flow.execute(function() { order.push(1); });
    });