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

package/test/io/io_test.js

@@ -1,364 +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.
-
-'use strict';
-
-var assert = require('assert'),
-    fs = require('fs'),
-    path = require('path'),
-    tmp = require('tmp');
-
-var io = require('../../io');
-
-
-describe('io', function() {
-  describe('copy', function() {
-    var tmpDir;
-
-    before(function() {
-      return io.tmpDir().then(function(d) {
-        tmpDir = d;
-
-        fs.writeFileSync(path.join(d, 'foo'), 'Hello, world');
-      });
-    });
-
-    it('can copy one file to another', function() {
-      return io.tmpFile().then(function(f) {
-        return io.copy(path.join(tmpDir, 'foo'), f).then(function(p) {
-          assert.equal(p, f);
-          assert.equal('Hello, world', fs.readFileSync(p));
-        });
-      });
-    });
-
-    it('can copy symlink to destination', function() {
-      if (process.platform === 'win32') {
-        return;  // No symlinks on windows.
-      }
-      fs.symlinkSync(
-          path.join(tmpDir, 'foo'),
-          path.join(tmpDir, 'symlinked-foo'));
-      return io.tmpFile().then(function(f) {
-        return io.copy(path.join(tmpDir, 'symlinked-foo'), f).then(function(p) {
-          assert.equal(p, f);
-          assert.equal('Hello, world', fs.readFileSync(p));
-        });
-      });
-    });
-
-    it('fails if given a directory as a source', function() {
-      return io.tmpFile().then(function(f) {
-        return io.copy(tmpDir, f);
-      }).then(function() {
-        throw Error('Should have failed with a type error');
-      }, function() {
-        // Do nothing; expected.
-      });
-    });
-  });
-
-  describe('copyDir', function() {
-    it('copies recursively', function() {
-      return io.tmpDir().then(function(dir) {
-        fs.writeFileSync(path.join(dir, 'file1'), 'hello');
-        fs.mkdirSync(path.join(dir, 'sub'));
-        fs.mkdirSync(path.join(dir, 'sub/folder'));
-        fs.writeFileSync(path.join(dir, 'sub/folder/file2'), 'goodbye');
-
-        return io.tmpDir().then(function(dst) {
-          return io.copyDir(dir, dst).then(function(ret) {
-            assert.equal(dst, ret);
-
-            assert.equal('hello',
-              fs.readFileSync(path.join(dst, 'file1')));
-            assert.equal('goodbye',
-              fs.readFileSync(path.join(dst, 'sub/folder/file2')));
-          });
-        });
-      });
-    });
-
-    it('creates destination dir if necessary', function() {
-      return io.tmpDir().then(function(srcDir) {
-        fs.writeFileSync(path.join(srcDir, 'foo'), 'hi');
-        return io.tmpDir().then(function(dstDir) {
-          return io.copyDir(srcDir, path.join(dstDir, 'sub'));
-        });
-      }).then(function(p) {
-        assert.equal('sub', path.basename(p));
-        assert.equal('hi', fs.readFileSync(path.join(p, 'foo')));
-      });
-    });
-
-    it('supports regex exclusion filter', function() {
-      return io.tmpDir().then(function(src) {
-        fs.writeFileSync(path.join(src, 'foo'), 'a');
-        fs.writeFileSync(path.join(src, 'bar'), 'b');
-        fs.writeFileSync(path.join(src, 'baz'), 'c');
-        fs.mkdirSync(path.join(src, 'sub'));
-        fs.writeFileSync(path.join(src, 'sub/quux'), 'd');
-        fs.writeFileSync(path.join(src, 'sub/quot'), 'e');
-
-        return io.tmpDir().then(function(dst) {
-          return io.copyDir(src, dst, /(bar|quux)/);
-        });
-      }).then(function(dir) {
-        assert.equal('a', fs.readFileSync(path.join(dir, 'foo')));
-        assert.equal('c', fs.readFileSync(path.join(dir, 'baz')));
-        assert.equal('e', fs.readFileSync(path.join(dir, 'sub/quot')));
-
-        assert.ok(!fs.existsSync(path.join(dir, 'bar')));
-        assert.ok(!fs.existsSync(path.join(dir, 'sub/quux')));
-      });
-    });
-
-    it('supports exclusion filter function', function() {
-      return io.tmpDir().then(function(src) {
-        fs.writeFileSync(path.join(src, 'foo'), 'a');
-        fs.writeFileSync(path.join(src, 'bar'), 'b');
-        fs.writeFileSync(path.join(src, 'baz'), 'c');
-        fs.mkdirSync(path.join(src, 'sub'));
-        fs.writeFileSync(path.join(src, 'sub/quux'), 'd');
-        fs.writeFileSync(path.join(src, 'sub/quot'), 'e');
-
-        return io.tmpDir().then(function(dst) {
-          return io.copyDir(src, dst, function(f) {
-            return f !== path.join(src, 'foo')
-                && f !== path.join(src, 'sub/quot');
-          });
-        });
-      }).then(function(dir) {
-        assert.equal('b', fs.readFileSync(path.join(dir, 'bar')));
-        assert.equal('c', fs.readFileSync(path.join(dir, 'baz')));
-        assert.equal('d', fs.readFileSync(path.join(dir, 'sub/quux')));
-
-        assert.ok(!fs.existsSync(path.join(dir, 'foo')));
-        assert.ok(!fs.existsSync(path.join(dir, 'sub/quot')));
-      });
-    });
-  });
-
-  describe('exists', function() {
-    var dir;
-
-    before(function() {
-      return io.tmpDir().then(function(d) {
-        dir = d;
-      });
-    });
-
-    it('returns a rejected promise if input value is invalid', function() {
-      return io.exists(undefined).then(
-          () => assert.fail('should have failed'),
-          e => assert.ok(e instanceof TypeError));
-    });
-
-    it('works for directories', function() {
-      return io.exists(dir).then(assert.ok);
-    });
-
-    it('works for files', function() {
-      var file = path.join(dir, 'foo');
-      fs.writeFileSync(file, '');
-      return io.exists(file).then(assert.ok);
-    });
-
-    it('does not return a rejected promise if file does not exist', function() {
-      return io.exists(path.join(dir, 'not-there')).then(function(exists) {
-        assert.ok(!exists);
-      });
-    });
-  });
-
-  describe('unlink', function() {
-    var dir;
-
-    before(function() {
-      return io.tmpDir().then(function(d) {
-        dir = d;
-      });
-    });
-
-    it('silently succeeds if the path does not exist', function() {
-      return io.unlink(path.join(dir, 'not-there'));
-    });
-
-    it('deletes files', function() {
-      var file = path.join(dir, 'foo');
-      fs.writeFileSync(file, '');
-      return io.exists(file).then(assert.ok).then(function() {
-        return io.unlink(file);
-      }).then(function() {
-        return io.exists(file);
-      }).then(function(exists) {
-        return assert.ok(!exists);
-      });
-    });
-  });
-
-  describe('rmDir', function() {
-    it('succeeds if the designated directory does not exist', function() {
-      return io.tmpDir().then(function(d) {
-        return io.rmDir(path.join(d, 'i/do/not/exist'));
-      });
-    });
-
-    it('deletes recursively', function() {
-      return io.tmpDir().then(function(dir) {
-        fs.writeFileSync(path.join(dir, 'file1'), 'hello');
-        fs.mkdirSync(path.join(dir, 'sub'));
-        fs.mkdirSync(path.join(dir, 'sub/folder'));
-        fs.writeFileSync(path.join(dir, 'sub/folder/file2'), 'goodbye');
-
-        return io.rmDir(dir).then(function() {
-          assert.ok(!fs.existsSync(dir));
-          assert.ok(!fs.existsSync(path.join(dir, 'sub/folder/file2')));
-        });
-      });
-    });
-  });
-
-  describe('findInPath', function() {
-    const savedPathEnv = process.env['PATH'];
-    afterEach(() => process.env['PATH'] = savedPathEnv);
-
-    const cwd = process.cwd;
-    afterEach(() => process.cwd = cwd);
-
-    let dirs;
-    beforeEach(() => {
-      return Promise.all([io.tmpDir(), io.tmpDir(), io.tmpDir()]).then(arr => {
-        dirs = arr;
-        process.env['PATH'] = arr.join(path.delimiter);
-      });
-    });
-
-    it('returns null if file cannot be found', () => {
-      assert.strictEqual(io.findInPath('foo.txt'), null);
-    });
-
-    it('can find file on path', () => {
-      let filePath = path.join(dirs[1], 'foo.txt');
-      fs.writeFileSync(filePath, 'hi');
-
-      assert.strictEqual(io.findInPath('foo.txt'), filePath);
-    });
-
-    it('returns null if file is in a subdir of a directory on the path', () => {
-      let subDir = path.join(dirs[2], 'sub');
-      fs.mkdirSync(subDir);
-
-      let filePath = path.join(subDir, 'foo.txt');
-      fs.writeFileSync(filePath, 'hi');
-
-      assert.strictEqual(io.findInPath('foo.txt'), null);
-    });
-
-    it('does not match on directories', () => {
-      fs.mkdirSync(path.join(dirs[2], 'sub'));
-      assert.strictEqual(io.findInPath('sub'), null);
-    });
-
-    it('will look in cwd first if requested', () => {
-      return io.tmpDir().then(fakeCwd => {
-        process.cwd = () => fakeCwd;
-
-        let theFile = path.join(fakeCwd, 'foo.txt');
-
-        fs.writeFileSync(path.join(dirs[1], 'foo.txt'), 'hi');
-        fs.writeFileSync(theFile, 'bye');
-
-        assert.strictEqual(io.findInPath('foo.txt', true), theFile);
-      });
-    });
-  });
-
-  describe('read', function() {
-    var tmpDir;
-
-    before(function() {
-      return io.tmpDir().then(function(d) {
-        tmpDir = d;
-
-        fs.writeFileSync(path.join(d, 'foo'), 'Hello, world');
-      });
-    });
-
-    it('can read a file', function() {
-      return io.read(path.join(tmpDir, 'foo')).then(buff => {
-        assert.ok(buff instanceof Buffer);
-        assert.equal('Hello, world', buff.toString());
-      });
-    });
-
-    it('catches errors from invalid input', function() {
-      return io.read({})
-          .then(() => assert.fail('should have failed'),
-                (e) => assert.ok(e instanceof TypeError));
-    });
-
-    it('rejects returned promise if file does not exist', function() {
-      return io.read(path.join(tmpDir, 'not-there'))
-          .then(() => assert.fail('should have failed'),
-                (e) => assert.equal('ENOENT', e.code));
-    });
-  });
-
-  describe('mkdirp', function() {
-    it('recursively creates entire directory path', function() {
-      return io.tmpDir().then(root => {
-        let dst = path.join(root, 'foo/bar/baz');
-        return io.mkdirp(dst).then(d => {
-          assert.strictEqual(d, dst);
-          return io.stat(d).then(stats => {
-            assert.ok(stats.isDirectory());
-          });
-        });
-      });
-    });
-
-    it('does nothing if the directory already exists', function() {
-      return io.tmpDir()
-          .then(dir => io.mkdirp(dir).then(d => assert.strictEqual(d, dir)));
-    });
-  });
-
-  describe('walkDir', function() {
-    it('walk directory', async function() {
-      let dir = await io.tmpDir();
-
-      fs.writeFileSync(path.join(dir, 'file1'), 'hello');
-      fs.mkdirSync(path.join(dir, 'sub'));
-      fs.mkdirSync(path.join(dir, 'sub/folder'));
-      fs.writeFileSync(path.join(dir, 'sub/folder/file2'), 'goodbye');
-
-      let seen = await io.walkDir(dir);
-      seen.sort((a, b) => {
-        if (a.path < b.path) return -1;
-        if (a.path > b.path) return 1;
-        return 0;
-      });
-      assert.deepStrictEqual(
-          seen,
-          [{path: 'file1', dir: false},
-           {path: 'sub', dir: true},
-           {path: path.join('sub', 'folder'), dir: true},
-           {path: path.join('sub', 'folder', 'file2'), dir: false}]);
-    });
-  })
-});

package/test/io/zip_test.js

@@ -1,126 +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.
-
-'use strict';
-
-const assert = require('assert');
-const fs = require('fs');
-const path = require('path');
-
-const io = require('../../io');
-const zip = require('../../io/zip');
-const {InvalidArgumentError} = require('../../lib/error');
-
-
-const XPI_PATH =
-    path.join(__dirname, '../../lib/test/data/firefox/webextension.xpi');
-
-describe('io/zip', function() {
-  describe('unzip', function() {
-    it('creates destination dir if necessary', function() {
-      return io.tmpDir()
-          .then(dir => zip.unzip(XPI_PATH, dir))
-          .then(dir => {
-            assertExists(path.join(dir, 'inject.js'));
-            assertExists(path.join(dir, 'manifest.json'));
-            assertExists(path.join(dir, 'META-INF/manifest.mf'));
-          });
-    });
-  });
-
-  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/by_test.js

@@ -1,160 +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.
-
-'use strict';
-
-var assert = require('assert');
-var by = require('../../lib/by');
-
-describe('by', function() {
-  describe('By', function() {
-    describe('className', function() {
-      it('delegates to By.css', function() {
-        let locator = by.By.className('foo');
-        assert.equal('css selector', locator.using);
-        assert.equal('.foo', locator.value);
-      });
-
-      it('escapes class name', function() {
-        let locator = by.By.className('foo#bar');
-        assert.equal('css selector', locator.using);
-        assert.equal('.foo\\#bar', locator.value);
-      });
-
-      it('translates compound class names', function() {
-        let locator = by.By.className('a b');
-        assert.equal('css selector', locator.using);
-        assert.equal('.a.b', locator.value);
-
-        locator = by.By.className('  x   y   z-1  "g" ');
-        assert.equal('css selector', locator.using);
-        assert.equal('.x.y.z-1.\\"g\\"', locator.value);
-      });
-    });
-
-    describe('id', function() {
-      it('delegates to By.css', function() {
-        let locator = by.By.id('foo');
-        assert.equal('css selector', locator.using);
-        assert.equal('*[id="foo"]', locator.value);
-      });
-
-      it('escapes the ID', function() {
-        let locator = by.By.id('foo#bar');
-        assert.equal('css selector', locator.using);
-        assert.equal('*[id="foo\\#bar"]', locator.value);
-      });
-    });
-
-    describe('name', function() {
-      it('delegates to By.css', function() {
-        let locator = by.By.name('foo')
-        assert.equal('css selector', locator.using);
-        assert.equal('*[name="foo"]', locator.value);
-      });
-
-      it('escapes the name', function() {
-        let locator = by.By.name('foo"bar"')
-        assert.equal('css selector', locator.using);
-        assert.equal('*[name="foo\\"bar\\""]', locator.value);
-      });
-
-      it('escapes the name when it starts with a number', function() {
-        let locator = by.By.name('123foo"bar"')
-        assert.equal('css selector', locator.using);
-        assert.equal('*[name="\\31 23foo\\"bar\\""]', locator.value);
-      });
-
-      it('escapes the name when it starts with a negative number', function() {
-        let locator = by.By.name('-123foo"bar"')
-        assert.equal('css selector', locator.using);
-        assert.equal('*[name="-\\31 23foo\\"bar\\""]', locator.value);
-      });
-    });
-  });
-
-  describe('checkedLocator', function() {
-    it('accepts a By instance', function() {
-      let original = by.By.name('foo');
-      let locator = by.checkedLocator(original);
-      assert.strictEqual(locator, original);
-    });
-
-    it('accepts custom locator functions', function() {
-      let original = function() {};
-      let locator = by.checkedLocator(original);
-      assert.strictEqual(locator, original);
-    });
-
-    // See https://github.com/SeleniumHQ/selenium/issues/3056
-    it('accepts By-like objects', function() {
-      let fakeBy = {using: 'id', value: 'foo'};
-      let locator = by.checkedLocator(fakeBy);
-      assert.strictEqual(locator.constructor, by.By);
-      assert.equal(locator.using, 'id');
-      assert.equal(locator.value, 'foo');
-    });
-
-    it('accepts class name', function() {
-      let locator = by.checkedLocator({className: 'foo'});
-      assert.equal('css selector', locator.using);
-      assert.equal('.foo', locator.value);
-    });
-
-    it('accepts css', function() {
-      let locator = by.checkedLocator({css: 'a > b'});
-      assert.equal('css selector', locator.using);
-      assert.equal('a > b', locator.value);
-    });
-
-    it('accepts id', function() {
-      let locator = by.checkedLocator({id: 'foobar'});
-      assert.equal('css selector', locator.using);
-      assert.equal('*[id="foobar"]', locator.value);
-    });
-
-    it('accepts linkText', function() {
-      let locator = by.checkedLocator({linkText: 'hello'});
-      assert.equal('link text', locator.using);
-      assert.equal('hello', locator.value);
-    });
-
-    it('accepts name', function() {
-      let locator = by.checkedLocator({name: 'foobar'});
-      assert.equal('css selector', locator.using);
-      assert.equal('*[name="foobar"]', locator.value);
-    });
-
-    it('accepts partialLinkText', function() {
-      let locator = by.checkedLocator({partialLinkText: 'hello'});
-      assert.equal('partial link text', locator.using);
-      assert.equal('hello', locator.value);
-    });
-
-    it('accepts tagName', function() {
-      let locator = by.checkedLocator({tagName: 'div'});
-      assert.equal('css selector', locator.using);
-      assert.equal('div', locator.value);
-    });
-
-    it('accepts xpath', function() {
-      let locator = by.checkedLocator({xpath: '//div[1]'});
-      assert.equal('xpath', locator.using);
-      assert.equal('//div[1]', locator.value);
-    });
-  });
-});