selenium-webdriver 2.47.0 → 2.52.0

package/test/chrome/options_test.js

@@ -21,6 +21,7 @@ var fs = require('fs');
 
 var webdriver = require('../..'),
     chrome = require('../../chrome'),
+    symbols = require('../../lib/symbols'),
     proxy = require('../../proxy'),
     assert = require('../../testing/assert');
 
@@ -28,7 +29,6 @@ var test = require('../../lib/test');
 
 
 describe('chrome.Options', function() {
-
   describe('fromCapabilities', function() {
 
     it('should return a new Options instance if none were defined',
@@ -58,7 +58,7 @@ describe('chrome.Options', function() {
       });
 
       var options = chrome.Options.fromCapabilities(caps);
-      var json = options.serialize();
+      var json = options[symbols.serialize]();
 
       assert(json.args.length).equalTo(2);
       assert(json.args[0]).equalTo('a');
@@ -79,7 +79,7 @@ describe('chrome.Options', function() {
           });
 
           var options = chrome.Options.fromCapabilities(caps);
-          var json = options.serialize();
+          var json = options[symbols.serialize]();
           assert(json.args).isUndefined();
           assert(json.binary).isUndefined();
           assert(json.detach).isUndefined();
@@ -109,10 +109,10 @@ describe('chrome.Options', function() {
   describe('addArguments', function() {
     it('takes var_args', function() {
       var options = new chrome.Options();
-      assert(options.serialize().args).isUndefined();
+      assert(options[symbols.serialize]().args).isUndefined();
 
       options.addArguments('a', 'b');
-      var json = options.serialize();
+      var json = options[symbols.serialize]();
       assert(json.args.length).equalTo(2);
       assert(json.args[0]).equalTo('a');
       assert(json.args[1]).equalTo('b');
@@ -120,10 +120,10 @@ describe('chrome.Options', function() {
 
     it('flattens input arrays', function() {
       var options = new chrome.Options();
-      assert(options.serialize().args).isUndefined();
+      assert(options[symbols.serialize]().args).isUndefined();
 
       options.addArguments(['a', 'b'], 'c', [1, 2], 3);
-      var json = options.serialize();
+      var json = options[symbols.serialize]();
       assert(json.args.length).equalTo(6);
       assert(json.args[0]).equalTo('a');
       assert(json.args[1]).equalTo('b');
@@ -163,7 +163,9 @@ describe('chrome.Options', function() {
   describe('serialize', function() {
     it('base64 encodes extensions', function() {
       var expected = fs.readFileSync(__filename, 'base64');
-      var wire = new chrome.Options().addExtensions(__filename).serialize();
+      var wire = new chrome.Options()
+          .addExtensions(__filename)
+          [symbols.serialize]();
       assert(wire.extensions.length).equalTo(1);
       assert(wire.extensions[0]).equalTo(expected);
     });
@@ -222,4 +224,4 @@ test.suite(function(env) {
       assert(userAgent).equalTo('foo;bar');
     });
   });
-}, {browsers: ['chrome']});
+}, {browsers: ['chrome']});

package/test/element_finding_test.js

@@ -23,6 +23,7 @@ var Browser = require('..').Browser,
     By = require('..').By,
     error = require('..').error,
     until = require('..').until,
+    promise = require('../lib/promise'),
     test = require('../lib/test'),
     assert = require('../testing/assert'),
     Pages = test.Pages;
@@ -42,7 +43,6 @@ test.suite(function(env) {
   });
 
   describe('finding elements', function() {
-
     test.it(
         'should work after loading multiple pages in a row',
         function() {
@@ -63,7 +63,7 @@ test.suite(function(env) {
         driver.get(Pages.formPage);
         driver.findElement(By.id('nonExistantButton')).
             then(fail, function(e) {
-              assert(e.code).equalTo(error.ErrorCode.NO_SUCH_ELEMENT);
+              assert(e).instanceOf(error.NoSuchElementError);
             });
       });
 
@@ -86,11 +86,12 @@ test.suite(function(env) {
       });
 
       test.it(
-        'should be able to find elements by partial link text', function() {
-          driver.get(Pages.xhtmlTestPage);
-          driver.findElement(By.partialLinkText('ick me')).click();
-          driver.wait(until.titleIs('We Arrive Here'), 5000);
-        });
+          'should be able to find elements by partial link text',
+          function() {
+            driver.get(Pages.xhtmlTestPage);
+            driver.findElement(By.partialLinkText('ick me')).click();
+            driver.wait(until.titleIs('We Arrive Here'), 5000);
+          });
 
       test.it('should work when link text contains equals sign', function() {
         driver.get(Pages.xhtmlTestPage);
@@ -230,7 +231,7 @@ test.suite(function(env) {
         driver.get(Pages.xhtmlTestPage);
         driver.findElement(By.className('nameB')).
             then(fail, function(e) {
-              assert(e.code).equalTo(error.ErrorCode.NO_SUCH_ELEMENT);
+              assert(e).instanceOf(error.NoSuchElementError);
             });
       });
 
@@ -241,11 +242,11 @@ test.suite(function(env) {
         });
       });
 
-      test.it('does not permit compound class names', function() {
-        driver.get(Pages.xhtmlTestPage);
-        driver.findElement(By.className('a b')).then(fail, pass);
-        driver.findElements(By.className('a b')).then(fail, pass);
-        function pass() {}
+      test.it('permits compound class names', function() {
+        return driver.get(Pages.xhtmlTestPage)
+            .then(() => driver.findElement(By.className('nameA nameC')))
+            .then(el => el.getText())
+            .then(text => assert(text).equalTo('An H2 title'));
       });
     });
 
@@ -350,5 +351,42 @@ test.suite(function(env) {
             assert(el.getAttribute('value')).equalTo('two');
           });
     });
+
+    describe('by custom locator', function() {
+      test.it('handles single element result', function() {
+        driver.get(Pages.javascriptPage);
+
+        let link = driver.findElement(function(driver) {
+          let links = driver.findElements(By.tagName('a'));
+          return promise.filter(links, function(link) {
+            return link.getAttribute('id').then(id => id === 'updatediv');
+          }).then(links => links[0]);
+        });
+
+        assert(link.getText()).isEqualTo('Update a div');
+      });
+
+      test.it('uses first element if locator resolves to list', function() {
+        driver.get(Pages.javascriptPage);
+
+        let link = driver.findElement(function() {
+          return driver.findElements(By.tagName('a'));
+        });
+
+        assert(link.getText()).isEqualTo('Change the page title!');
+      });
+
+      test.it('fails if locator returns non-webelement value', function() {
+        driver.get(Pages.javascriptPage);
+
+        let link = driver.findElement(function() {
+          return driver.getTitle();
+        });
+
+        return link.then(
+            () => fail('Should have failed'),
+            (e) => assert(e).instanceOf(TypeError));
+      });
+    });
   });
 });

package/test/error_test.js

@@ -0,0 +1,163 @@
+// 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';
+
+describe('error', function() {
+  let assert = require('assert');
+  let error = require('../error');
+
+  describe('checkResponse', function() {
+    it('defaults to WebDriverError if type is unrecognized', function() {
+      assert.throws(
+          () => error.checkResponse({error: 'foo', message: 'hi there'}),
+          (e) => {
+            assert.equal(e.constructor, error.WebDriverError);
+            assert.equal(e.code, error.ErrorCode.UNKNOWN_ERROR);
+            return true;
+          });
+    });
+
+    it('does not throw if error property is not a string', function() {
+      let resp = {error: 123, message: 'abc123'};
+      let out = error.checkResponse(resp);
+      assert.strictEqual(out, resp);
+    });
+
+    test('unknown error', error.WebDriverError);
+    test('element not selectable', error.ElementNotSelectableError);
+    test('element not visible', error.ElementNotVisibleError);
+    test('invalid argument', error.InvalidArgumentError);
+    test('invalid cookie domain', error.InvalidCookieDomainError);
+    test('invalid element coordinates', error.InvalidElementCoordinatesError);
+    test('invalid element state', error.InvalidElementStateError);
+    test('invalid selector', error.InvalidSelectorError);
+    test('invalid session id', error.InvalidSessionIdError);
+    test('javascript error', error.JavascriptError);
+    test('move target out of bounds', error.MoveTargetOutOfBoundsError);
+    test('no such alert', error.NoSuchAlertError);
+    test('no such element', error.NoSuchElementError);
+    test('no such frame', error.NoSuchFrameError);
+    test('no such window', error.NoSuchWindowError);
+    test('script timeout', error.ScriptTimeoutError);
+    test('session not created', error.SessionNotCreatedError);
+    test('stale element reference', error.StaleElementReferenceError);
+    test('timeout', error.TimeoutError);
+    test('unable to set cookie', error.UnableToSetCookieError);
+    test('unable to capture screen', error.UnableToCaptureScreenError);
+    test('unexpected alert open', error.UnexpectedAlertOpenError);
+    test('unknown command', error.UnknownCommandError);
+    test('unknown method', error.UnknownMethodError);
+    test('unsupported operation', error.UnsupportedOperationError);
+
+    function test(status, expectedType) {
+      it(`"${status}" => ${expectedType.name}`, function() {
+        assert.throws(
+            () => error.checkResponse({error: status, message: 'oops'}),
+            (e) => {
+              assert.equal(expectedType, e.constructor);
+              assert.equal(e.message, 'oops');
+              return true;
+            });
+      });
+    }
+  });
+
+  describe('checkLegacyResponse', function() {
+    it('does not throw for success', function() {
+      let resp = {status: error.ErrorCode.SUCCESS};
+      assert.strictEqual(resp, error.checkLegacyResponse(resp));
+    });
+
+    test('NO_SUCH_ELEMENT', error.NoSuchElementError);
+    test('NO_SUCH_FRAME', error.NoSuchFrameError);
+    test('UNKNOWN_COMMAND', error.UnsupportedOperationError);
+    test('UNSUPPORTED_OPERATION', error.UnsupportedOperationError);
+    test('STALE_ELEMENT_REFERENCE', error.StaleElementReferenceError);
+    test('ELEMENT_NOT_VISIBLE', error.ElementNotVisibleError);
+    test('INVALID_ELEMENT_STATE', error.InvalidElementStateError);
+    test('UNKNOWN_ERROR', error.WebDriverError);
+    test('ELEMENT_NOT_SELECTABLE', error.ElementNotSelectableError);
+    test('JAVASCRIPT_ERROR', error.JavascriptError);
+    test('XPATH_LOOKUP_ERROR', error.InvalidSelectorError);
+    test('TIMEOUT', error.TimeoutError);
+    test('NO_SUCH_WINDOW', error.NoSuchWindowError);
+    test('INVALID_COOKIE_DOMAIN', error.InvalidCookieDomainError);
+    test('UNABLE_TO_SET_COOKIE', error.UnableToSetCookieError);
+    test('UNEXPECTED_ALERT_OPEN', error.UnexpectedAlertOpenError);
+    test('NO_SUCH_ALERT', error.NoSuchAlertError);
+    test('SCRIPT_TIMEOUT', error.ScriptTimeoutError);
+    test('INVALID_ELEMENT_COORDINATES', error.InvalidElementCoordinatesError);
+    test('INVALID_SELECTOR_ERROR', error.InvalidSelectorError);
+    test('SESSION_NOT_CREATED', error.SessionNotCreatedError);
+    test('MOVE_TARGET_OUT_OF_BOUNDS', error.MoveTargetOutOfBoundsError);
+    test('INVALID_XPATH_SELECTOR', error.InvalidSelectorError);
+    test('INVALID_XPATH_SELECTOR_RETURN_TYPE', error.InvalidSelectorError);
+    test('METHOD_NOT_ALLOWED', error.UnsupportedOperationError);
+
+    function test(codeKey, expectedType) {
+      it(`${codeKey} => ${expectedType.name}`, function() {
+        let code = error.ErrorCode[codeKey];
+        let resp = {status: code, value: {message: 'hi'}};
+        assert.throws(
+            () => error.checkLegacyResponse(resp),
+            (e) => {
+              assert.equal(expectedType, e.constructor);
+              assert.equal(e.message, 'hi');
+              return true;
+            });
+      });
+    }
+  });
+
+  describe('WebDriverError types provide a legacy error code', function() {
+    check(error.WebDriverError, 'UNKNOWN_ERROR');
+    check(error.ElementNotSelectableError, 'ELEMENT_NOT_SELECTABLE');
+    check(error.ElementNotVisibleError, 'ELEMENT_NOT_VISIBLE');
+    check(error.InvalidArgumentError, 'UNKNOWN_ERROR');
+    check(error.InvalidCookieDomainError, 'INVALID_COOKIE_DOMAIN');
+    check(error.InvalidElementCoordinatesError, 'INVALID_ELEMENT_COORDINATES');
+    check(error.InvalidElementStateError, 'INVALID_ELEMENT_STATE');
+    check(error.InvalidSelectorError, 'INVALID_SELECTOR_ERROR');
+    check(error.InvalidSessionIdError, 'UNKNOWN_ERROR');
+    check(error.JavascriptError, 'JAVASCRIPT_ERROR');
+    check(error.MoveTargetOutOfBoundsError, 'MOVE_TARGET_OUT_OF_BOUNDS');
+    check(error.NoSuchAlertError, 'NO_SUCH_ALERT');
+    check(error.NoSuchElementError, 'NO_SUCH_ELEMENT');
+    check(error.NoSuchFrameError, 'NO_SUCH_FRAME');
+    check(error.NoSuchWindowError, 'NO_SUCH_WINDOW');
+    check(error.ScriptTimeoutError, 'SCRIPT_TIMEOUT');
+    check(error.SessionNotCreatedError, 'SESSION_NOT_CREATED');
+    check(error.StaleElementReferenceError, 'STALE_ELEMENT_REFERENCE');
+    check(error.TimeoutError, 'TIMEOUT');
+    check(error.UnableToSetCookieError, 'UNABLE_TO_SET_COOKIE');
+    check(error.UnableToCaptureScreenError, 'UNKNOWN_ERROR');
+    check(error.UnexpectedAlertOpenError, 'UNEXPECTED_ALERT_OPEN');
+    check(error.UnknownCommandError, 'UNKNOWN_COMMAND');
+    check(error.UnknownMethodError, 'UNSUPPORTED_OPERATION');
+    check(error.UnsupportedOperationError, 'UNSUPPORTED_OPERATION');
+
+    function check(ctor, codeKey) {
+      it(`${ctor.name} => ${codeKey}`, function() {
+        let code = error.ErrorCode[codeKey];
+        let e = new ctor();
+        assert.equal(typeof e.code, 'number');
+        assert.equal(e.code, code);
+      });
+    }
+  });
+});

package/test/execute_script_test.js

@@ -58,7 +58,7 @@ test.suite(function(env) {
       execute('throw function\\*')
           .then(function() { throw shoudlHaveFailed; })
           .thenCatch(function(e) {
-            assert(e).not.equalTo(shouldHaveFailed);
+            assert(e).notEqualTo(shouldHaveFailed);
           });
     });
 

package/test/firefox/firefox_test.js

@@ -155,5 +155,29 @@ test.suite(function(env) {
         });
       });
     });
+
+    describe('binary management', function() {
+      var driver1, driver2;
+
+      test.ignore(env.isRemote).
+      it('can start multiple sessions with single binary instance', function() {
+        var options = new firefox.Options().setBinary(new firefox.Binary);
+        env.builder().setFirefoxOptions(options);
+        driver1 = env.builder().build();
+        driver2 = env.builder().build();
+        // Ok if this doesn't fail.
+      });
+
+      test.afterEach(function() {
+        if (driver1) {
+          driver1.quit();
+        }
+
+        if (driver2) {
+          driver2.quit();
+        }
+      });
+    });
+
   });
 }, {browsers: ['firefox']});