selenium-webdriver 3.3.0 → 4.0.0-alpha.1

package/firefox/profile.js

@@ -1,430 +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.
-
-/**
- * @fileoverview Profile management module. This module is considered internal;
- * users should use {@link selenium-webdriver/firefox}.
- */
-
-'use strict';
-
-const AdmZip = require('adm-zip'),
-    fs = require('fs'),
-    path = require('path'),
-    vm = require('vm');
-
-const isDevMode = require('../lib/devmode'),
-    Symbols = require('../lib/symbols'),
-    io = require('../io'),
-    extension = require('./extension');
-
-
-/** @const */
-const WEBDRIVER_PREFERENCES_PATH = isDevMode
-    ? path.join(__dirname, '../../../firefox-driver/webdriver.json')
-    : path.join(__dirname, '../lib/firefox/webdriver.json');
-
-/** @const */
-const WEBDRIVER_EXTENSION_PATH = isDevMode
-    ? path.join(__dirname,
-        '../../../../build/javascript/firefox-driver/webdriver.xpi')
-    : path.join(__dirname, '../lib/firefox/webdriver.xpi');
-
-/** @const */
-const WEBDRIVER_EXTENSION_NAME = 'fxdriver@googlecode.com';
-
-
-
-/** @type {Object} */
-var defaultPreferences = null;
-
-/**
- * Synchronously loads the default preferences used for the FirefoxDriver.
- * @return {!Object} The default preferences JSON object.
- */
-function getDefaultPreferences() {
-  if (!defaultPreferences) {
-    var contents = /** @type {string} */(
-        fs.readFileSync(WEBDRIVER_PREFERENCES_PATH, 'utf8'));
-    defaultPreferences = /** @type {!Object} */(JSON.parse(contents));
-  }
-  return defaultPreferences;
-}
-
-
-/**
- * Parses a user.js file in a Firefox profile directory.
- * @param {string} f Path to the file to parse.
- * @return {!Promise<!Object>} A promise for the parsed preferences as
- *     a JSON object. If the file does not exist, an empty object will be
- *     returned.
- */
-function loadUserPrefs(f) {
-  return io.read(f).then(
-      function onSuccess(contents) {
-        var prefs = {};
-        var context = vm.createContext({
-          'user_pref': function(key, value) {
-            prefs[key] = value;
-          }
-        });
-        vm.runInContext(contents.toString(), context, f);
-        return prefs;
-      },
-      function onError(err) {
-        if (err && err.code === 'ENOENT') {
-          return {};
-        }
-        throw err;
-      });
-}
-
-
-
-/**
- * @param {!Object} prefs The default preferences to write. Will be
- *     overridden by user.js preferences in the template directory and the
- *     frozen preferences required by WebDriver.
- * @param {string} dir Path to the directory write the file to.
- * @return {!Promise<string>} A promise for the profile directory,
- *     to be fulfilled when user preferences have been written.
- */
-function writeUserPrefs(prefs, dir) {
-  var userPrefs = path.join(dir, 'user.js');
-  return loadUserPrefs(userPrefs).then(function(overrides) {
-    Object.assign(prefs, overrides);
-    Object.assign(prefs, getDefaultPreferences()['frozen']);
-
-    var contents = Object.keys(prefs).map(function(key) {
-      return 'user_pref(' + JSON.stringify(key) + ', ' +
-          JSON.stringify(prefs[key]) + ');';
-    }).join('\n');
-
-    return new Promise((resolve, reject) => {
-      fs.writeFile(userPrefs, contents, function(err) {
-        err && reject(err) || resolve(dir);
-      });
-    });
-  });
-};
-
-
-/**
- * Installs a group of extensions in the given profile directory. If the
- * WebDriver extension is not included in this set, the default version
- * bundled with this package will be installed.
- * @param {!Array.<string>} extensions The extensions to install, as a
- *     path to an unpacked extension directory or a path to a xpi file.
- * @param {string} dir The profile directory to install to.
- * @param {boolean=} opt_excludeWebDriverExt Whether to skip installation of
- *     the default WebDriver extension.
- * @return {!Promise<string>} A promise for the main profile directory
- *     once all extensions have been installed.
- */
-function installExtensions(extensions, dir, opt_excludeWebDriverExt) {
-  var hasWebDriver = !!opt_excludeWebDriverExt;
-  var next = 0;
-  var extensionDir = path.join(dir, 'extensions');
-
-  return new Promise(function(fulfill, reject) {
-    io.mkdir(extensionDir).then(installNext, reject);
-
-    function installNext() {
-      if (next >= extensions.length) {
-        if (hasWebDriver) {
-          fulfill(dir);
-        } else {
-          install(WEBDRIVER_EXTENSION_PATH);
-        }
-      } else {
-        install(extensions[next++]);
-      }
-    }
-
-    function install(ext) {
-      extension.install(ext, extensionDir).then(function(id) {
-        hasWebDriver = hasWebDriver || (id === WEBDRIVER_EXTENSION_NAME);
-        installNext();
-      }, reject);
-    }
-  });
-}
-
-
-/**
- * Decodes a base64 encoded profile.
- * @param {string} data The base64 encoded string.
- * @return {!Promise<string>} A promise for the path to the decoded profile
- *     directory.
- */
-function decode(data) {
-  return io.tmpFile().then(function(file) {
-    var buf = new Buffer(data, 'base64');
-    return io.write(file, buf)
-        .then(io.tmpDir)
-        .then(function(dir) {
-          var zip = new AdmZip(file);
-          zip.extractAllTo(dir);  // Sync only? Why?? :-(
-          return dir;
-        });
-  });
-}
-
-
-
-/**
- * Models a Firefox profile directory for use with the FirefoxDriver. The
- * {@code Profile} directory uses an in-memory model until
- * {@link #writeToDisk} or {@link #encode} is called.
- */
-class Profile {
-  /**
-   * @param {string=} opt_dir Path to an existing Firefox profile directory to
-   *     use a template for this profile. If not specified, a blank profile will
-   *     be used.
-   */
-  constructor(opt_dir) {
-    /** @private {!Object} */
-    this.preferences_ = {};
-
-    /** @private {boolean} */
-    this.nativeEventsEnabled_ = true;
-
-    /** @private {(string|undefined)} */
-    this.template_ = opt_dir;
-
-    /** @private {number} */
-    this.port_ = 0;
-
-    /** @private {!Array<string>} */
-    this.extensions_ = [];
-  }
-
-  /**
-   * @return {(string|undefined)} Path to an existing Firefox profile directory
-   *     to use as a template when writing this Profile to disk.
-   */
-  getTemplateDir() {
-    return this.template_;
-  }
-
-  /**
-   * Registers an extension to be included with this profile.
-   * @param {string} extension Path to the extension to include, as either an
-   *     unpacked extension directory or the path to a xpi file.
-   */
-  addExtension(extension) {
-    this.extensions_.push(extension);
-  }
-
-  /**
-   * @return {!Array<string>} A list of extensions to install in this profile.
-   */
-  getExtensions() {
-    return this.extensions_;
-  }
-
-  /**
-   * Sets a desired preference for this profile.
-   * @param {string} key The preference key.
-   * @param {(string|number|boolean)} value The preference value.
-   * @throws {Error} If attempting to set a frozen preference.
-   */
-  setPreference(key, value) {
-    var frozen = getDefaultPreferences()['frozen'];
-    if (frozen.hasOwnProperty(key) && frozen[key] !== value) {
-      throw Error('You may not set ' + key + '=' + JSON.stringify(value)
-          + '; value is frozen for proper WebDriver functionality ('
-          + key + '=' + JSON.stringify(frozen[key]) + ')');
-    }
-    this.preferences_[key] = value;
-  }
-
-  /**
-   * Returns the currently configured value of a profile preference. This does
-   * not include any defaults defined in the profile's template directory user.js
-   * file (if a template were specified on construction).
-   * @param {string} key The desired preference.
-   * @return {(string|number|boolean|undefined)} The current value of the
-   *     requested preference.
-   */
-  getPreference(key) {
-    return this.preferences_[key];
-  }
-
-  /**
-   * @return {!Object} A copy of all currently configured preferences.
-   */
-  getPreferences() {
-    return Object.assign({}, this.preferences_);
-  }
-
-  /**
-   * Specifies which host the driver should listen for commands on. If not
-   * specified, the driver will default to "localhost". This option should be
-   * specified when "localhost" is not mapped to the loopback address
-   * (127.0.0.1) in `/etc/hosts`.
-   *
-   * @param {string} host the host the driver should listen for commands on
-   */
-  setHost(host) {
-    this.preferences_['webdriver_firefox_allowed_hosts'] = host;
-  }
-
-  /**
-   * @return {number} The port this profile is currently configured to use, or
-   *     0 if the port will be selected at random when the profile is written
-   *     to disk.
-   */
-  getPort() {
-    return this.port_;
-  }
-
-  /**
-   * Sets the port to use for the WebDriver extension loaded by this profile.
-   * @param {number} port The desired port, or 0 to use any free port.
-   */
-  setPort(port) {
-    this.port_ = port;
-  }
-
-  /**
-   * @return {boolean} Whether the FirefoxDriver is configured to automatically
-   *     accept untrusted SSL certificates.
-   */
-  acceptUntrustedCerts() {
-    return !!this.preferences_['webdriver_accept_untrusted_certs'];
-  }
-
-  /**
-   * Sets whether the FirefoxDriver should automatically accept untrusted SSL
-   * certificates.
-   * @param {boolean} value .
-   */
-  setAcceptUntrustedCerts(value) {
-    this.preferences_['webdriver_accept_untrusted_certs'] = !!value;
-  }
-
-  /**
-   * Sets whether to assume untrusted certificates come from untrusted issuers.
-   * @param {boolean} value .
-   */
-  setAssumeUntrustedCertIssuer(value) {
-    this.preferences_['webdriver_assume_untrusted_issuer'] = !!value;
-  }
-
-  /**
-   * @return {boolean} Whether to assume untrusted certs come from untrusted
-   *     issuers.
-   */
-  assumeUntrustedCertIssuer() {
-    return !!this.preferences_['webdriver_assume_untrusted_issuer'];
-  }
-
-  /**
-   * Sets whether to use native events with this profile.
-   * @param {boolean} enabled .
-   */
-  setNativeEventsEnabled(enabled) {
-    this.nativeEventsEnabled_ = enabled;
-  }
-
-  /**
-   * Returns whether native events are enabled in this profile.
-   * @return {boolean} .
-   */
-  nativeEventsEnabled() {
-    return this.nativeEventsEnabled_;
-  }
-
-  /**
-   * Writes this profile to disk.
-   * @param {boolean=} opt_excludeWebDriverExt Whether to exclude the WebDriver
-   *     extension from the generated profile. Used to reduce the size of an
-   *     {@link #encode() encoded profile} since the server will always install
-   *     the extension itself.
-   * @return {!Promise<string>} A promise for the path to the new profile
-   *     directory.
-   */
-  writeToDisk(opt_excludeWebDriverExt) {
-    var profileDir = io.tmpDir();
-    if (this.template_) {
-      profileDir = profileDir.then(function(dir) {
-        return io.copyDir(
-            /** @type {string} */(this.template_),
-            dir, /(parent\.lock|lock|\.parentlock)/);
-      }.bind(this));
-    }
-
-    // Freeze preferences for async operations.
-    var prefs = {};
-    Object.assign(prefs, getDefaultPreferences()['mutable']);
-    Object.assign(prefs, getDefaultPreferences()['frozen']);
-    Object.assign(prefs, this.preferences_);
-
-    // Freeze extensions for async operations.
-    var extensions = this.extensions_.concat();
-
-    return profileDir.then(function(dir) {
-      return writeUserPrefs(prefs, dir);
-    }).then(function(dir) {
-      return installExtensions(extensions, dir, !!opt_excludeWebDriverExt);
-    });
-  }
-
-  /**
-   * Write profile to disk, compress its containing directory, and return
-   * it as a Base64 encoded string.
-   *
-   * @return {!Promise<string>} A promise for the encoded profile as
-   *     Base64 string.
-   *
-   */
-  encode() {
-    return this.writeToDisk(true).then(function(dir) {
-      var zip = new AdmZip();
-      zip.addLocalFolder(dir, '');
-      // Stored compression, see https://en.wikipedia.org/wiki/Zip_(file_format)
-      zip.getEntries().forEach(function(entry) {
-        entry.header.method = 0;
-      });
-
-      return io.tmpFile().then(function(file) {
-        zip.writeZip(file);  // Sync! Why oh why :-(
-        return io.read(file);
-      });
-    }).then(function(data) {
-      return data.toString('base64');
-    });
-  }
-
-  /**
-   * Encodes this profile as a zipped, base64 encoded directory.
-   * @return {!Promise<string>} A promise for the encoded profile.
-   */
-  [Symbols.serialize]() {
-    return this.encode();
-  }
-}
-
-
-// PUBLIC API
-
-
-exports.Profile = Profile;
-exports.decode = decode;
-exports.loadUserPrefs = loadUserPrefs;

package/lib/atoms/getAttribute.js

@@ -1,12 +0,0 @@
-// GENERATED CODE - DO NOT EDIT
-module.exports = function(){return function(){var aa="function"==typeof Object.defineProperties?Object.defineProperty:function(a,c,b){if(b.get||b.set)throw new TypeError("ES3 does not support getters and setters.");a!=Array.prototype&&a!=Object.prototype&&(a[c]=b.value)},ba="undefined"!=typeof window&&window===this?this:"undefined"!=typeof global?global:this;
-function e(a,c){if(c){for(var b=ba,d=a.split("."),f=0;f<d.length-1;f++){var h=d[f];h in b||(b[h]={});b=b[h]}d=d[d.length-1];f=b[d];h=c(f);h!=f&&null!=h&&aa(b,d,{configurable:!0,writable:!0,value:h})}}
-e("String.prototype.repeat",function(a){return a?a:function(a){var b;if(null==this)throw new TypeError("The 'this' value for String.prototype.repeat must not be null or undefined");b=this+"";if(0>a||1342177279<a)throw new RangeError("Invalid count value");a|=0;for(var d="";a;)if(a&1&&(d+=b),a>>>=1)b+=b;return d}});e("Math.sign",function(a){return a?a:function(a){a=Number(a);return!a||isNaN(a)?a:0<a?1:-1}});var g=this;function l(a){return"string"==typeof a};function m(a,c){this.a=n[a]||p;this.message=c||"";var b=this.a.replace(/((?:^|\s+)[a-z])/g,function(a){return a.toUpperCase().replace(/^[\s\xa0]+/g,"")}),d=b.length-5;if(0>d||b.indexOf("Error",d)!=d)b+="Error";this.name=b;b=Error(this.message);b.name=this.name;this.stack=b.stack||""}
-(function(){var a=Error;function c(){}c.prototype=a.prototype;m.b=a.prototype;m.prototype=new c;m.prototype.constructor=m;m.a=function(b,c,f){for(var h=Array(arguments.length-2),k=2;k<arguments.length;k++)h[k-2]=arguments[k];return a.prototype[c].apply(b,h)}})();var p="unknown error",n={15:"element not selectable",11:"element not visible"};n[31]=p;n[30]=p;n[24]="invalid cookie domain";n[29]="invalid element coordinates";n[12]="invalid element state";n[32]="invalid selector";n[51]="invalid selector";
-n[52]="invalid selector";n[17]="javascript error";n[405]="unsupported operation";n[34]="move target out of bounds";n[27]="no such alert";n[7]="no such element";n[8]="no such frame";n[23]="no such window";n[28]="script timeout";n[33]="session not created";n[10]="stale element reference";n[21]="timeout";n[25]="unable to set cookie";n[26]="unexpected alert open";n[13]=p;n[9]="unknown command";m.prototype.toString=function(){return this.name+": "+this.message};var q=String.prototype.trim?function(a){return a.trim()}:function(a){return a.replace(/^[\s\xa0]+|[\s\xa0]+$/g,"")};
-function r(a,c){for(var b=0,d=q(String(a)).split("."),f=q(String(c)).split("."),h=Math.max(d.length,f.length),k=0;!b&&k<h;k++){var S=d[k]||"",ja=f[k]||"",ka=RegExp("(\\d*)(\\D*)","g"),la=RegExp("(\\d*)(\\D*)","g");do{var t=ka.exec(S)||["","",""],u=la.exec(ja)||["","",""];if(0==t[0].length&&0==u[0].length)break;b=v(0==t[1].length?0:parseInt(t[1],10),0==u[1].length?0:parseInt(u[1],10))||v(0==t[2].length,0==u[2].length)||v(t[2],u[2])}while(!b)}return b}function v(a,c){return a<c?-1:a>c?1:0};var w;a:{var x=g.navigator;if(x){var y=x.userAgent;if(y){w=y;break a}}w=""}function z(a){return-1!=w.indexOf(a)};function ca(a,c){for(var b=a.length,d=l(a)?a.split(""):a,f=0;f<b;f++)f in d&&c.call(void 0,d[f],f,a)};function A(){return z("iPhone")&&!z("iPod")&&!z("iPad")};function B(){return z("Opera")||z("OPR")}function C(){return(z("Chrome")||z("CriOS"))&&!B()&&!z("Edge")};var D=B(),E=z("Trident")||z("MSIE"),F=z("Edge"),G=z("Gecko")&&!(-1!=w.toLowerCase().indexOf("webkit")&&!z("Edge"))&&!(z("Trident")||z("MSIE"))&&!z("Edge"),da=-1!=w.toLowerCase().indexOf("webkit")&&!z("Edge");function ea(){var a=w;if(G)return/rv\:([^\);]+)(\)|;)/.exec(a);if(F)return/Edge\/([\d\.]+)/.exec(a);if(E)return/\b(?:MSIE|rv)[: ]([^\);]+)(\)|;)/.exec(a);if(da)return/WebKit\/(\S+)/.exec(a)}function H(){var a=g.document;return a?a.documentMode:void 0}
-var I=function(){if(D&&g.opera){var a;var c=g.opera.version;try{a=c()}catch(b){a=c}return a}a="";(c=ea())&&(a=c?c[1]:"");return E&&(c=H(),null!=c&&c>parseFloat(a))?String(c):a}(),J={},K=g.document,L=K&&E?H()||("CSS1Compat"==K.compatMode?parseInt(I,10):5):void 0;!G&&!E||E&&9<=Number(L)||G&&(J["1.9.1"]||(J["1.9.1"]=0<=r(I,"1.9.1")));E&&(J["9"]||(J["9"]=0<=r(I,"9")));var fa=z("Firefox"),ga=A()||z("iPod"),ha=z("iPad"),M=z("Android")&&!(C()||z("Firefox")||B()||z("Silk")),ia=C(),N=z("Safari")&&!(C()||z("Coast")||B()||z("Edge")||z("Silk")||z("Android"))&&!(A()||z("iPad")||z("iPod"));var ma={SCRIPT:1,STYLE:1,HEAD:1,IFRAME:1,OBJECT:1},na={IMG:" ",BR:"\n"};function oa(a,c,b){if(!(a.nodeName in ma))if(3==a.nodeType)b?c.push(String(a.nodeValue).replace(/(\r\n|\r|\n)/g,"")):c.push(a.nodeValue);else if(a.nodeName in na)c.push(na[a.nodeName]);else for(a=a.firstChild;a;)oa(a,c,b),a=a.nextSibling};function O(a){return(a=a.exec(w))?a[1]:""}var pa=function(){if(fa)return O(/Firefox\/([0-9.]+)/);if(E||F||D)return I;if(ia)return O(/Chrome\/([0-9.]+)/);if(N&&!(A()||z("iPad")||z("iPod")))return O(/Version\/([0-9.]+)/);if(ga||ha){var a=/Version\/(\S+).*Mobile\/(\S+)/.exec(w);if(a)return a[1]+"."+a[2]}else if(M)return(a=O(/Android\s+([0-9.]+)/))?a:O(/Version\/([0-9.]+)/);return""}();var qa;function P(a){ra?qa(a):M?r(sa,a):r(pa,a)}var ra=function(){if(!G)return!1;var a=g.Components;if(!a)return!1;try{if(!a.classes)return!1}catch(f){return!1}var c=a.classes,a=a.interfaces,b=c["@mozilla.org/xpcom/version-comparator;1"].getService(a.nsIVersionComparator),d=c["@mozilla.org/xre/app-info;1"].getService(a.nsIXULAppInfo).version;qa=function(a){b.compare(d,""+a)};return!0}(),Q;if(M){var ta=/Android\s+([0-9\.]+)/.exec(w);Q=ta?ta[1]:"0"}else Q="0";
-var sa=Q,ua=E&&!(8<=Number(L)),va=E&&!(9<=Number(L));M&&P(2.3);M&&P(4);N&&P(6);function R(a,c){c=c.toLowerCase();if("style"==c)return wa(a.style.cssText);if(ua&&"value"==c&&T(a,"INPUT"))return a.value;if(va&&!0===a[c])return String(a.getAttribute(c));var b=a.getAttributeNode(c);return b&&b.specified?b.value:null}var xa=/[;]+(?=(?:(?:[^"]*"){2})*[^"]*$)(?=(?:(?:[^']*'){2})*[^']*$)(?=(?:[^()]*\([^()]*\))*[^()]*$)/;
-function wa(a){var c=[];ca(a.split(xa),function(a){var d=a.indexOf(":");0<d&&(a=[a.slice(0,d),a.slice(d+1)],2==a.length&&c.push(a[0].toLowerCase(),":",a[1],";"))});c=c.join("");return c=";"==c.charAt(c.length-1)?c:c+";"}function U(a,c){var b;ua&&"value"==c&&T(a,"OPTION")&&null===R(a,"value")?(b=[],oa(a,b,!1),b=b.join("")):b=a[c];return b}function T(a,c){return!!a&&1==a.nodeType&&(!c||a.tagName.toUpperCase()==c)}
-function ya(a){return T(a,"OPTION")?!0:T(a,"INPUT")?(a=a.type.toLowerCase(),"checkbox"==a||"radio"==a):!1};var za={"class":"className",readonly:"readOnly"},V="async autofocus autoplay checked compact complete controls declare defaultchecked defaultselected defer disabled draggable ended formnovalidate hidden indeterminate iscontenteditable ismap itemscope loop multiple muted nohref noresize noshade novalidate nowrap open paused pubdate readonly required reversed scoped seamless seeking selected spellcheck truespeed willvalidate".split(" ");function Aa(a,c){var b=null,d=c.toLowerCase();if("style"==d)return(b=a.style)&&!l(b)&&(b=b.cssText),b;if(("selected"==d||"checked"==d)&&ya(a)){if(!ya(a))throw new m(15,"Element is not selectable");var b="selected",f=a.type&&a.type.toLowerCase();if("checkbox"==f||"radio"==f)b="checked";return U(a,b)?"true":null}var h=T(a,"A");if(T(a,"IMG")&&"src"==d||h&&"href"==d)return(b=R(a,d))&&(b=U(a,d)),b;if("spellcheck"==d){b=R(a,d);if(null!==b){if("false"==b.toLowerCase())return"false";if("true"==b.toLowerCase())return"true"}return U(a,
-d)+""}h=za[c]||c;a:if(l(V))d=l(d)&&1==d.length?V.indexOf(d,0):-1;else{for(var k=0;k<V.length;k++)if(k in V&&V[k]===d){d=k;break a}d=-1}if(0<=d)return(b=null!==R(a,c)||U(a,h))?"true":null;try{f=U(a,h)}catch(S){}(d=null==f)||(d=typeof f,d="object"==d&&null!=f||"function"==d);d?b=R(a,c):b=f;return null!=b?b.toString():null}var W=["_"],X=g;W[0]in X||!X.execScript||X.execScript("var "+W[0]);for(var Y;W.length&&(Y=W.shift());){var Z;if(Z=!W.length)Z=void 0!==Aa;Z?X[Y]=Aa:X[Y]?X=X[Y]:X=X[Y]={}};; return this._.apply(null,arguments);}.apply({navigator:typeof window!='undefined'?window.navigator:null,document:typeof window!='undefined'?window.document:null}, arguments);};

package/lib/events.js

@@ -1,210 +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';
-
-/**
- * Describes an event listener registered on an {@linkplain EventEmitter}.
- */
-class Listener {
-  /**
-   * @param {!Function} fn The actual listener function.
-   * @param {(Object|undefined)} scope The object in whose scope to invoke the
-   *     listener.
-   * @param {boolean} oneshot Whether this listener should only be used once.
-   */
-  constructor(fn, scope, oneshot) {
-    this.fn = fn;
-    this.scope = scope;
-    this.oneshot = oneshot;
-  }
-}
-
-
-/** @type {!WeakMap<!EventEmitter, !Map<string, !Set<!Listener>>>} */
-const EVENTS = new WeakMap;
-
-
-/**
- * Object that can emit events for others to listen for.
- */
-class EventEmitter {
-  /**
-   * Fires an event and calls all listeners.
-   * @param {string} type The type of event to emit.
-   * @param {...*} var_args Any arguments to pass to each listener.
-   */
-  emit(type, var_args) {
-    let events = EVENTS.get(this);
-    if (!events) {
-      return;
-    }
-
-    let args = Array.prototype.slice.call(arguments, 1);
-
-    let listeners = events.get(type);
-    if (listeners) {
-      for (let listener of listeners) {
-        listener.fn.apply(listener.scope, args);
-        if (listener.oneshot) {
-          listeners.delete(listener);
-        }
-      }
-    }
-  }
-
-  /**
-   * Returns a mutable list of listeners for a specific type of event.
-   * @param {string} type The type of event to retrieve the listeners for.
-   * @return {!Set<!Listener>} The registered listeners for the given event
-   *     type.
-   */
-  listeners(type) {
-    let events = EVENTS.get(this);
-    if (!events) {
-      events = new Map;
-      EVENTS.set(this, events);
-    }
-
-    let listeners = events.get(type);
-    if (!listeners) {
-      listeners = new Set;
-      events.set(type, listeners);
-    }
-    return listeners;
-  }
-
-  /**
-   * Registers a listener.
-   * @param {string} type The type of event to listen for.
-   * @param {!Function} fn The function to invoke when the event is fired.
-   * @param {Object=} opt_self The object in whose scope to invoke the listener.
-   * @param {boolean=} opt_oneshot Whether the listener should b (e removed after
-   *    the first event is fired.
-   * @return {!EventEmitter} A self reference.
-   * @private
-   */
-  addListener_(type, fn, opt_self, opt_oneshot) {
-    let listeners = this.listeners(type);
-    for (let listener of listeners) {
-      if (listener.fn === fn) {
-        return this;
-      }
-    }
-    listeners.add(new Listener(fn, opt_self || undefined, !!opt_oneshot));
-    return this;
-  }
-
-  /**
-   * Registers a listener.
-   * @param {string} type The type of event to listen for.
-   * @param {!Function} fn The function to invoke when the event is fired.
-   * @param {Object=} opt_self The object in whose scope to invoke the listener.
-   * @return {!EventEmitter} A self reference.
-   */
-  addListener(type, fn, opt_self) {
-    return this.addListener_(type, fn, opt_self, false);
-  }
-
-  /**
-   * Registers a one-time listener which will be called only the first time an
-   * event is emitted, after which it will be removed.
-   * @param {string} type The type of event to listen for.
-   * @param {!Function} fn The function to invoke when the event is fired.
-   * @param {Object=} opt_self The object in whose scope to invoke the listener.
-   * @return {!EventEmitter} A self reference.
-   */
-  once(type, fn, opt_self) {
-    return this.addListener_(type, fn, opt_self, true);
-  }
-
-  /**
-   * An alias for {@link #addListener() addListener()}.
-   * @param {string} type The type of event to listen for.
-   * @param {!Function} fn The function to invoke when the event is fired.
-   * @param {Object=} opt_self The object in whose scope to invoke the listener.
-   * @return {!EventEmitter} A self reference.
-   */
-  on(type, fn, opt_self) {
-    return this.addListener(type, fn, opt_self);
-  }
-
-  /**
-   * Removes a previously registered event listener.
-   * @param {string} type The type of event to unregister.
-   * @param {!Function} listenerFn The handler function to remove.
-   * @return {!EventEmitter} A self reference.
-   */
-  removeListener(type, listenerFn) {
-    if (typeof type !== 'string' || typeof listenerFn !== 'function') {
-      throw TypeError('invalid args: expected (string, function), got ('
-          + (typeof type) + ', ' + (typeof listenerFn) + ')');
-    }
-
-    let events = EVENTS.get(this);
-    if (!events) {
-      return this;
-    }
-
-    let listeners = events.get(type);
-    if (!listeners) {
-      return this;
-    }
-
-    let match;
-    for (let listener of listeners) {
-      if (listener.fn === listenerFn) {
-        match = listener;
-        break;
-      }
-    }
-    if (match) {
-      listeners.delete(match);
-      if (!listeners.size) {
-        events.delete(type);
-      }
-    }
-    return this;
-  }
-
-  /**
-   * Removes all listeners for a specific type of event. If no event is
-   * specified, all listeners across all types will be removed.
-   * @param {string=} opt_type The type of event to remove listeners from.
-   * @return {!EventEmitter} A self reference.
-   */
-  removeAllListeners(opt_type) {
-    let events = EVENTS.get(this);
-    if (events) {
-      if (typeof opt_type === 'string') {
-        events.delete(opt_type);
-      } else {
-        EVENTS.delete(this);
-      }
-    }
-    return this;
-  }
-}
-
-
-// PUBLIC API
-
-
-module.exports = {
-  EventEmitter: EventEmitter,
-  Listener: Listener
-};