selenium-webdriver 3.4.0 → 3.5.0

package/test/io/zip_test.js

@@ -0,0 +1,128 @@
+// 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('assert');
+const fs = require('fs');
+const path = require('path');
+
+const io = require('../../io');
+const devmode = require('../../lib/devmode');
+const zip = require('../../io/zip');
+const {InvalidArgumentError} = require('../../lib/error');
+
+
+const SAMPLE_XPI_PATH =
+    path.join(__dirname, '../../lib/test/data/firefox/sample.xpi');
+
+describe('io/zip', function() {
+  describe('unzip', function() {
+    it('creates destination dir if necessary', function() {
+      return io.tmpDir()
+          .then(dir => zip.unzip(SAMPLE_XPI_PATH, dir))
+          .then(dir => {
+            assertExists(path.join(dir, 'chrome.manifest'));
+            assertExists(path.join(dir, 'content/overlay.js'));
+            assertExists(path.join(dir, 'content/overlay.xul'));
+            assertExists(path.join(dir, 'install.rdf'));
+          });
+    });
+  });
+
+  describe('Zip', function() {
+    let dir;
+
+    beforeEach(function() {
+      return io.tmpDir().then(d => dir = d);
+    });
+
+    it('can convert an archive to a buffer', function() {
+      let z = new zip.Zip;
+      return io.mkdirp(path.join(dir, 'a/b/c/d/e')).then(() => {
+        return Promise.all([
+          io.write(path.join(dir, 'foo'), 'a file'),
+          io.write(path.join(dir, 'a/b/c/carrot'), 'an orange carrot'),
+          io.write(path.join(dir, 'a/b/c/d/e/elephant'), 'e is for elephant')
+        ]);
+      })
+      .then(() => z.addDir(dir))
+      .then(() => Promise.all([io.tmpDir(), z.toBuffer()]))
+      .then(([outDir, buf]) => {
+        let output = path.join(outDir, 'out.zip');
+        return io.write(output, buf)
+            .then(() => io.tmpDir())
+            .then(d => zip.unzip(output, d))
+            .then(d => {
+              assertContents(path.join(d, 'foo'), 'a file');
+              assertContents(path.join(d, 'a/b/c/carrot'), 'an orange carrot');
+              assertContents(
+                  path.join(d, 'a/b/c/d/e/elephant'),
+                  'e is for elephant');
+            });
+      });
+    });
+
+    describe('getFile', function() {
+      it('returns archive file contents as a buffer', function() {
+        let foo = path.join(dir, 'foo');
+        fs.writeFileSync(foo, 'hello, world!');
+
+        let z = new zip.Zip;
+        return z.addFile(foo).then(() => {
+          assert.ok(z.has('foo'));
+          return z.getFile('foo');
+        }).then(
+            buffer => assert.equal(buffer.toString('utf8'), 'hello, world!'));
+      });
+
+      it('returns an error if file is not in archive', function() {
+        let z = new zip.Zip;
+        assert.ok(!z.has('some-file'));
+        return z.getFile('some-file')
+            .then(() => assert.fail('should have failed'),
+                  e => assert.strictEqual(e.constructor, InvalidArgumentError));
+      });
+
+      it(
+          'returns a rejected promise if the requested path is a directory',
+          function() {
+            let file = path.join(dir, 'aFile');
+            fs.writeFileSync(file, 'hello, world!');
+
+            let z = new zip.Zip;
+            return z.addDir(dir, 'foo')
+                .then(() => z.getFile('foo'))
+                .then(
+                    () => assert.fail('should have failed'),
+                    e => assert.strictEqual(
+                        e.constructor, InvalidArgumentError))
+                .then(() => z.getFile('foo/aFile'))
+                .then(b => assert.equal(b.toString('utf8'), 'hello, world!'));
+          });
+    });
+  });
+
+  function assertExists(p) {
+    assert.ok(fs.existsSync(p), `expected ${p} to exist`);
+  }
+
+  function assertContents(p, c) {
+    assert.strictEqual(
+        fs.readFileSync(p, 'utf8'), c, `unexpected file contents for ${p}`);
+  }
+});

package/test/lib/error_test.js

@@ -187,13 +187,32 @@ describe('error', function() {
     test('unknown method', error.UnknownMethodError);
     test('unsupported operation', error.UnsupportedOperationError);
 
+    it('leaves remoteStacktrace empty if not in encoding', function() {
+      assert.throws(
+          () => error.throwDecodedError({
+            error: 'session not created',
+            message: 'oops'
+          }),
+          (e) => {
+            assert.strictEqual(e.constructor, error.SessionNotCreatedError);
+            assert.strictEqual(e.message, 'oops');
+            assert.strictEqual(e.remoteStacktrace, '');
+            return true;
+          });
+    });
+
     function test(status, expectedType) {
       it(`"${status}" => ${expectedType.name}`, function() {
         assert.throws(
-            () => error.throwDecodedError({error: status, message: 'oops'}),
+            () => error.throwDecodedError({
+              error: status,
+              message: 'oops',
+              stacktrace: 'some-stacktrace'
+            }),
             (e) => {
               assert.strictEqual(e.constructor, expectedType);
               assert.strictEqual(e.message, 'oops');
+              assert.strictEqual(e.remoteStacktrace, 'some-stacktrace');
               return true;
             });
       });

package/test/lib/webdriver_test.js

@@ -403,7 +403,7 @@ describe('WebDriver', function() {
 
       var driver =
           WebDriver.createSession(executor, {'browserName': 'firefox'},
-              null, null, () => called = true);
+              null, () => called = true);
       return driver.getSession().then(fail, err => {
         assert.ok(called);
         assertIsStubError(err);
@@ -464,8 +464,7 @@ describe('WebDriver', function() {
               .end();
 
           WebDriver.createSession(
-              executor, {'browserName': 'firefox'}, null, null,
-              () => {throw e});
+              executor, {'browserName': 'firefox'}, null, () => {throw e});
           return waitForAbort().then(err => assert.strictEqual(err, e));
         });
       });
@@ -1446,6 +1445,7 @@ describe('WebDriver', function() {
       let executor = new FakeExecutor().
           expect(CName.SEND_KEYS_TO_ELEMENT,
                  {'id': WebElement.buildId('one'),
+                  'text': '12abc3',
                   'value':'12abc3'.split('')}).
               andReturnSuccess().
           end();
@@ -1463,6 +1463,7 @@ describe('WebDriver', function() {
               andReturnSuccess(WebElement.buildId('one')).
           expect(CName.SEND_KEYS_TO_ELEMENT,
                  {'id':WebElement.buildId('one'),
+                  'text': 'abc123def',
                   'value':'abc123def'.split('')}).
               andReturnSuccess().
           end();
@@ -1482,6 +1483,7 @@ describe('WebDriver', function() {
               andReturnSuccess(WebElement.buildId('one')).
           expect(CName.SEND_KEYS_TO_ELEMENT,
                  {'id': WebElement.buildId('one'),
+                  'text': 'modified/path',
                   'value':'modified/path'.split('')}).
               andReturnSuccess().
           end();

package/test/page_loading_test.js

@@ -57,12 +57,6 @@ test.suite(function(env) {
     return assert(driver.getTitle()).equalTo('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');
-  });
-
   // 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*() {

package/test/remote_test.js

@@ -83,7 +83,7 @@ describe('FileDetector', function() {
   }
 
   it('returns the original path if the file does not exist', function() {
-    return io.tmpDir(dir => {
+    return io.tmpDir().then(dir => {
       let theFile = path.join(dir, 'not-there');
       return (new remote.FileDetector)
           .handleFile(new ExplodingDriver, theFile)
@@ -92,7 +92,7 @@ describe('FileDetector', function() {
   });
 
   it('returns the original path if it is a directory', function() {
-    return io.tmpDir(dir => {
+    return io.tmpDir().then(dir => {
       return (new remote.FileDetector)
           .handleFile(new ExplodingDriver, dir)
           .then(f => assert.equal(f, dir));
@@ -100,7 +100,7 @@ describe('FileDetector', function() {
   });
 
   it('attempts to upload valid files', function() {
-    return io.tmpFile(theFile => {
+    return io.tmpFile().then(theFile => {
       return (new remote.FileDetector)
           .handleFile(
               new (class FakeDriver {

package/test/session_test.js

@@ -17,38 +17,83 @@
 
 'use strict';
 
-var WebDriver = require('..').WebDriver,
-    assert = require('../testing/assert'),
-    test = require('../lib/test'),
-    Pages = test.Pages;
+const assert = require('../testing/assert');
+const chrome = require('../chrome');
+const edge = require('../edge');
+const firefox = require('../firefox');
+const ie = require('../ie');
+const opera = require('../opera');
+const phantomjs = require('../phantomjs');
+const safari = require('../safari');
+const test = require('../lib/test');
+const {Browser} = require('../lib/capabilities');
+const {Pages} = require('../lib/test');
+const {WebDriver} = require('..');
 
 
 test.suite(function(env) {
   var browsers = env.browsers;
 
-  var driver;
-  test.before(function*() {
-    driver = yield env.builder().build();
-  });
+  const BROWSER_MAP = new Map([
+    [Browser.CHROME, chrome.Driver],
+    [Browser.EDGE, edge.Driver],
+    [Browser.FIREFOX, firefox.Driver],
+    [Browser.INTERNET_EXPLORER, ie.Driver],
+    [Browser.OPERA, opera.Driver],
+    [Browser.PHANTOM_JS, phantomjs.Driver],
+    [Browser.SAFARI, safari.Driver],
+  ]);
 
-  test.after(function() {
-    return driver.quit();
-  });
+  if (BROWSER_MAP.has(env.currentBrowser())) {
+    describe('builder creates thenable driver instances', function() {
+      let driver;
+
+      after(() => driver && driver.quit());
+
+      it(env.currentBrowser(), function() {
+        driver = env.builder().build();
+
+        const want = BROWSER_MAP.get(env.currentBrowser());
+        assert(driver).instanceOf(want,
+            `want ${want.name}, but got ${driver.name}`);
+        assert(typeof driver.then).equalTo('function');
+
+        return driver
+            .then(
+                d => assert(d)
+                    .instanceOf(want, `want ${want.name}, but got ${d.name}`))
+            // Load something so the safari driver doesn't crash from starting and
+            // stopping in short time.
+            .then(() => driver.get(Pages.echoPage));
+      });
+    });
+  }
+
+  describe('session management', function() {
+    var driver;
+    test.before(function*() {
+      driver = yield env.builder().build();
+    });
+
+    test.after(function() {
+      return driver.quit();
+    });
 
-  test.it('can connect to an existing session', function*() {
-    yield driver.get(Pages.simpleTestPage);
-    yield assert(driver.getTitle()).equalTo('Hello WebDriver');
+    test.it('can connect to an existing session', function*() {
+      yield driver.get(Pages.simpleTestPage);
+      yield assert(driver.getTitle()).equalTo('Hello WebDriver');
 
-    return driver.getSession().then(session1 => {
-      let driver2 = WebDriver.attachToSession(
-          driver.getExecutor(),
-          session1.getId());
+      return driver.getSession().then(session1 => {
+        let driver2 = WebDriver.attachToSession(
+            driver.getExecutor(),
+            session1.getId());
 
-      return assert(driver2.getTitle()).equalTo('Hello WebDriver')
-          .then(_ => {
-            let session2Id = driver2.getSession().then(s => s.getId());
-            return assert(session2Id).equalTo(session1.getId());
-          });
+        return assert(driver2.getTitle()).equalTo('Hello WebDriver')
+            .then(_ => {
+              let session2Id = driver2.getSession().then(s => s.getId());
+              return assert(session2Id).equalTo(session1.getId());
+            });
+      });
     });
   });
 });