selenium-webdriver 2.48.2 → 2.52.0

package/chrome.js

@@ -49,17 +49,17 @@
  * You may also create a {@link Driver} with its own driver service. This is
  * useful if you need to capture the server's log output for a specific session:
  *
- *     var chrome = require('selenium-webdriver/chrome');
+ *     let chrome = require('selenium-webdriver/chrome');
  *
- *     var service = new chrome.ServiceBuilder()
+ *     let service = new chrome.ServiceBuilder()
  *         .loggingTo('/my/log/file.txt')
  *         .enableVerboseLogging()
  *         .build();
  *
- *     var options = new chrome.Options();
+ *     let options = new chrome.Options();
  *     // configure browser options ...
  *
- *     var driver = new chrome.Driver(options, service);
+ *     let driver = new chrome.Driver(options, service);
  *
  * Users should only instantiate the {@link Driver} class directly when they
  * need a custom driver service configuration (as shown above). For normal
@@ -78,7 +78,7 @@
  * will require configuring a [custom server](#custom-server) that will connect
  * to adb on the {@linkplain ServiceBuilder#setAdbPort correct port}:
  *
- *     var service = new chrome.ServiceBuilder()
+ *     let service = new chrome.ServiceBuilder()
  *         .setAdbPort(1234)
  *         build();
  *     // etc.
@@ -86,7 +86,7 @@
  * The ChromeDriver may be configured to launch Chrome on Android using
  * {@link Options#androidChrome()}:
  *
- *     var driver = new Builder()
+ *     let driver = new Builder()
  *         .forBrowser('chrome')
  *         .setChromeOptions(new chrome.Options().androidChrome())
  *         .build();
@@ -95,7 +95,7 @@
  * Chrome-WebView by setting the {@linkplain Options#androidActivity
  * androidActivity} option:
  *
- *     var driver = new Builder()
+ *     let driver = new Builder()
  *         .forBrowser('chrome')
  *         .setChromeOptions(new chrome.Options()
  *             .androidPackage('com.example')
@@ -114,13 +114,19 @@
 
 'use strict';
 
-var fs = require('fs'),
+const fs = require('fs'),
     util = require('util');
 
-var webdriver = require('./index'),
-    executors = require('./executors'),
+const executors = require('./executors'),
     http = require('./http'),
     io = require('./io'),
+    Capabilities = require('./lib/capabilities').Capabilities,
+    Capability = require('./lib/capabilities').Capability,
+    command = require('./lib/command'),
+    logging = require('./lib/logging'),
+    promise = require('./lib/promise'),
+    Symbols = require('./lib/symbols'),
+    webdriver = require('./lib/webdriver'),
     portprober = require('./net/portprober'),
     remote = require('./remote');
 
@@ -130,7 +136,7 @@ var webdriver = require('./index'),
  * @type {string}
  * @const
  */
-var CHROMEDRIVER_EXE =
+const CHROMEDRIVER_EXE =
     process.platform === 'win32' ? 'chromedriver.exe' : 'chromedriver';
 
 
@@ -138,20 +144,20 @@ var CHROMEDRIVER_EXE =
  * Custom command names supported by ChromeDriver.
  * @enum {string}
  */
-var Command = {
+const Command = {
   LAUNCH_APP: 'launchApp'
 };
 
 
 /**
  * Creates a command executor with support for ChromeDriver's custom commands.
- * @param {!webdriver.promise.Promise<string>} url The server's URL.
- * @return {!webdriver.CommandExecutor} The new command executor.
+ * @param {!promise.Promise<string>} url The server's URL.
+ * @return {!command.Executor} The new command executor.
  */
 function createExecutor(url) {
   return new executors.DeferredExecutor(url.then(function(url) {
-    var client = new http.HttpClient(url);
-    var executor = new http.Executor(client);
+    let client = new http.HttpClient(url);
+    let executor = new http.Executor(client);
     executor.defineCommand(
         Command.LAUNCH_APP,
         'POST', '/session/:sessionId/chromium/launch_app');
@@ -164,177 +170,170 @@ function createExecutor(url) {
  * Creates {@link selenium-webdriver/remote.DriverService} instances that manage
  * a [ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/)
  * server in a child process.
- *
- * @param {string=} opt_exe Path to the server executable to use. If omitted,
- *     the builder will attempt to locate the chromedriver on the current
- *     PATH.
- * @throws {Error} If provided executable does not exist, or the chromedriver
- *     cannot be found on the PATH.
- * @constructor
  */
-var ServiceBuilder = function(opt_exe) {
-  /** @private {string} */
-  this.exe_ = opt_exe || io.findInPath(CHROMEDRIVER_EXE, true);
-  if (!this.exe_) {
-    throw Error(
-        'The ChromeDriver could not be found on the current PATH. Please ' +
-        'download the latest version of the ChromeDriver from ' +
-        'http://chromedriver.storage.googleapis.com/index.html and ensure ' +
-        'it can be found on your PATH.');
-  }
-
-  if (!fs.existsSync(this.exe_)) {
-    throw Error('File does not exist: ' + this.exe_);
-  }
-
-  /** @private {!Array.<string>} */
-  this.args_ = [];
-  this.stdio_ = 'ignore';
-};
-
-
-/** @private {string} */
-ServiceBuilder.prototype.path_ = null;
-
-/** @private {number} */
-ServiceBuilder.prototype.port_ = 0;
+class ServiceBuilder {
+  /**
+   * @param {string=} opt_exe Path to the server executable to use. If omitted,
+   *     the builder will attempt to locate the chromedriver on the current
+   *     PATH.
+   * @throws {Error} If provided executable does not exist, or the chromedriver
+   *     cannot be found on the PATH.
+   */
+  constructor(opt_exe) {
+    let exe = opt_exe || io.findInPath(CHROMEDRIVER_EXE, true);
+    if (!exe) {
+      throw Error(
+          'The ChromeDriver could not be found on the current PATH. Please ' +
+          'download the latest version of the ChromeDriver from ' +
+          'http://chromedriver.storage.googleapis.com/index.html and ensure ' +
+          'it can be found on your PATH.');
+    }
 
+    if (!fs.existsSync(exe)) {
+      throw Error('File does not exist: ' + exe);
+    }
+    /** @private {string} */
+    this.exe_ = exe;
 
-/** @private {(string|!Array.<string|number|!Stream|null|undefined>)} */
-ServiceBuilder.prototype.stdio_ = 'ignore';
+    /** @private {!Array<string>} */
+    this.args_ = [];
 
+    /**
+     * @private {(string|!Array<string|number|!stream.Stream|null|undefined>)}
+     */
+    this.stdio_ = 'ignore';
 
-/** @private {Object.<string, string>} */
-ServiceBuilder.prototype.env_ = null;
+    /** @private {?string} */
+    this.path_ = null;
 
+    /** @private {number} */
+    this.port_ = 0;
 
-/**
- * Sets the port to start the ChromeDriver on.
- * @param {number} port The port to use, or 0 for any free port.
- * @return {!ServiceBuilder} A self reference.
- * @throws {Error} If the port is invalid.
- */
-ServiceBuilder.prototype.usingPort = function(port) {
-  if (port < 0) {
-    throw Error('port must be >= 0: ' + port);
+    /** @private {Object<string, string>} */
+    this.env_ = null;
   }
-  this.port_ = port;
-  return this;
-};
-
-
-/**
- * Sets which port adb is listening to. _The ChromeDriver will connect to adb
- * if an {@linkplain Options#androidPackage Android session} is requested, but
- * adb **must** be started beforehand._
- *
- * @param {number} port Which port adb is running on.
- * @return {!ServiceBuilder} A self reference.
- */
-ServiceBuilder.prototype.setAdbPort = function(port) {
-  this.args_.push('--adb-port=' + port);
-  return this;
-};
-
-
-/**
- * Sets the path of the log file the driver should log to. If a log file is
- * not specified, the driver will log to stderr.
- * @param {string} path Path of the log file to use.
- * @return {!ServiceBuilder} A self reference.
- */
-ServiceBuilder.prototype.loggingTo = function(path) {
-  this.args_.push('--log-path=' + path);
-  return this;
-};
-
-
-/**
- * Enables verbose logging.
- * @return {!ServiceBuilder} A self reference.
- */
-ServiceBuilder.prototype.enableVerboseLogging = function() {
-  this.args_.push('--verbose');
-  return this;
-};
 
+  /**
+   * Sets the port to start the ChromeDriver on.
+   * @param {number} port The port to use, or 0 for any free port.
+   * @return {!ServiceBuilder} A self reference.
+   * @throws {Error} If the port is invalid.
+   */
+  usingPort(port) {
+    if (port < 0) {
+      throw Error('port must be >= 0: ' + port);
+    }
+    this.port_ = port;
+    return this;
+  }
 
-/**
- * Sets the number of threads the driver should use to manage HTTP requests.
- * By default, the driver will use 4 threads.
- * @param {number} n The number of threads to use.
- * @return {!ServiceBuilder} A self reference.
- */
-ServiceBuilder.prototype.setNumHttpThreads = function(n) {
-  this.args_.push('--http-threads=' + n);
-  return this;
-};
+  /**
+   * Sets which port adb is listening to. _The ChromeDriver will connect to adb
+   * if an {@linkplain Options#androidPackage Android session} is requested, but
+   * adb **must** be started beforehand._
+   *
+   * @param {number} port Which port adb is running on.
+   * @return {!ServiceBuilder} A self reference.
+   */
+  setAdbPort(port) {
+    this.args_.push('--adb-port=' + port);
+    return this;
+  }
 
+  /**
+   * Sets the path of the log file the driver should log to. If a log file is
+   * not specified, the driver will log to stderr.
+   * @param {string} path Path of the log file to use.
+   * @return {!ServiceBuilder} A self reference.
+   */
+  loggingTo(path) {
+    this.args_.push('--log-path=' + path);
+    return this;
+  }
 
-/**
- * Sets the base path for WebDriver REST commands (e.g. "/wd/hub").
- * By default, the driver will accept commands relative to "/".
- * @param {string} path The base path to use.
- * @return {!ServiceBuilder} A self reference.
- */
-ServiceBuilder.prototype.setUrlBasePath = function(path) {
-  this.args_.push('--url-base=' + path);
-  this.path_ = path;
-  return this;
-};
+  /**
+   * Enables verbose logging.
+   * @return {!ServiceBuilder} A self reference.
+   */
+  enableVerboseLogging() {
+    this.args_.push('--verbose');
+    return this;
+  }
 
+  /**
+   * Sets the number of threads the driver should use to manage HTTP requests.
+   * By default, the driver will use 4 threads.
+   * @param {number} n The number of threads to use.
+   * @return {!ServiceBuilder} A self reference.
+   */
+  setNumHttpThreads(n) {
+    this.args_.push('--http-threads=' + n);
+    return this;
+  }
 
-/**
- * Defines the stdio configuration for the driver service. See
- * {@code child_process.spawn} for more information.
- * @param {(string|!Array.<string|number|!Stream|null|undefined>)} config The
- *     configuration to use.
- * @return {!ServiceBuilder} A self reference.
- */
-ServiceBuilder.prototype.setStdio = function(config) {
-  this.stdio_ = config;
-  return this;
-};
+  /**
+   * Sets the base path for WebDriver REST commands (e.g. "/wd/hub").
+   * By default, the driver will accept commands relative to "/".
+   * @param {string} path The base path to use.
+   * @return {!ServiceBuilder} A self reference.
+   */
+  setUrlBasePath(path) {
+    this.args_.push('--url-base=' + path);
+    this.path_ = path;
+    return this;
+  }
 
+  /**
+   * Defines the stdio configuration for the driver service. See
+   * {@code child_process.spawn} for more information.
+   * @param {(string|!Array<string|number|!stream.Stream|null|undefined>)}
+   *     config The configuration to use.
+   * @return {!ServiceBuilder} A self reference.
+   */
+  setStdio(config) {
+    this.stdio_ = config;
+    return this;
+  }
 
-/**
- * Defines the environment to start the server under. This settings will be
- * inherited by every browser session started by the server.
- * @param {!Object.<string, string>} env The environment to use.
- * @return {!ServiceBuilder} A self reference.
- */
-ServiceBuilder.prototype.withEnvironment = function(env) {
-  this.env_ = env;
-  return this;
-};
+  /**
+   * Defines the environment to start the server under. This settings will be
+   * inherited by every browser session started by the server.
+   * @param {!Object<string, string>} env The environment to use.
+   * @return {!ServiceBuilder} A self reference.
+   */
+  withEnvironment(env) {
+    this.env_ = env;
+    return this;
+  }
 
+  /**
+   * Creates a new DriverService using this instance's current configuration.
+   * @return {!remote.DriverService} A new driver service using this instance's
+   *     current configuration.
+   * @throws {Error} If the driver exectuable was not specified and a default
+   *     could not be found on the current PATH.
+   */
+  build() {
+    let port = this.port_ || portprober.findFreePort();
+    let args = this.args_.concat();  // Defensive copy.
+
+    return new remote.DriverService(this.exe_, {
+      loopback: true,
+      path: this.path_,
+      port: port,
+      args: promise.when(port, function(port) {
+        return args.concat('--port=' + port);
+      }),
+      env: this.env_,
+      stdio: this.stdio_
+    });
+  }
+}
 
-/**
- * Creates a new DriverService using this instance's current configuration.
- * @return {remote.DriverService} A new driver service using this instance's
- *     current configuration.
- * @throws {Error} If the driver exectuable was not specified and a default
- *     could not be found on the current PATH.
- */
-ServiceBuilder.prototype.build = function() {
-  var port = this.port_ || portprober.findFreePort();
-  var args = this.args_.concat();  // Defensive copy.
-
-  return new remote.DriverService(this.exe_, {
-    loopback: true,
-    path: this.path_,
-    port: port,
-    args: webdriver.promise.when(port, function(port) {
-      return args.concat('--port=' + port);
-    }),
-    env: this.env_,
-    stdio: this.stdio_
-  });
-};
 
 
 /** @type {remote.DriverService} */
-var defaultService = null;
+let defaultService = null;
 
 
 /**
@@ -370,472 +369,436 @@ function getDefaultService() {
  * @type {string}
  * @const
  */
-var OPTIONS_CAPABILITY_KEY = 'chromeOptions';
+let OPTIONS_CAPABILITY_KEY = 'chromeOptions';
 
 
 /**
  * Class for managing ChromeDriver specific options.
- * @constructor
- * @extends {webdriver.Serializable}
  */
-var Options = function() {
-  webdriver.Serializable.call(this);
+class Options {
+  constructor() {
+    /** @private {!Object} */
+    this.options_ = {};
 
-  /** @private {!Object} */
-  this.options_ = {};
+    /** @private {!Array<(string|!Buffer)>} */
+    this.extensions_ = [];
 
-  /** @private {!Array.<(string|!Buffer)>} */
-  this.extensions_ = [];
+    /** @private {?logging.Preferences} */
+    this.logPrefs_ = null;
 
-  /** @private {?webdriver.logging.Preferences} */
-  this.logPrefs_ = null;
+    /** @private {?./lib/capabilities.ProxyConfig} */
+    this.proxy_ = null;
+  }
 
-  /** @private {?webdriver.ProxyConfig} */
-  this.proxy_ = null;
-};
-util.inherits(Options, webdriver.Serializable);
+  /**
+   * Extracts the ChromeDriver specific options from the given capabilities
+   * object.
+   * @param {!Capabilities} caps The capabilities object.
+   * @return {!Options} The ChromeDriver options.
+   */
+  static fromCapabilities(caps) {
+    let options = new Options();
+
+    let o = caps.get(OPTIONS_CAPABILITY_KEY);
+    if (o instanceof Options) {
+      options = o;
+    } else if (o) {
+      options.
+          addArguments(o.args || []).
+          addExtensions(o.extensions || []).
+          detachDriver(o.detach).
+          excludeSwitches(o.excludeSwitches || []).
+          setChromeBinaryPath(o.binary).
+          setChromeLogFile(o.logPath).
+          setChromeMinidumpPath(o.minidumpPath).
+          setLocalState(o.localState).
+          setMobileEmulation(o.mobileEmulation).
+          setUserPreferences(o.prefs).
+          setPerfLoggingPrefs(o.perfLoggingPrefs);
+    }
 
+    if (caps.has(Capability.PROXY)) {
+      options.setProxy(caps.get(Capability.PROXY));
+    }
 
-/**
- * Extracts the ChromeDriver specific options from the given capabilities
- * object.
- * @param {!webdriver.Capabilities} capabilities The capabilities object.
- * @return {!Options} The ChromeDriver options.
- */
-Options.fromCapabilities = function(capabilities) {
-  var options = new Options();
+    if (caps.has(Capability.LOGGING_PREFS)) {
+      options.setLoggingPrefs(
+          caps.get(Capability.LOGGING_PREFS));
+    }
 
-  var o = capabilities.get(OPTIONS_CAPABILITY_KEY);
-  if (o instanceof Options) {
-    options = o;
-  } else if (o) {
-    options.
-        addArguments(o.args || []).
-        addExtensions(o.extensions || []).
-        detachDriver(o.detach).
-        excludeSwitches(o.excludeSwitches || []).
-        setChromeBinaryPath(o.binary).
-        setChromeLogFile(o.logPath).
-        setChromeMinidumpPath(o.minidumpPath).
-        setLocalState(o.localState).
-        setMobileEmulation(o.mobileEmulation).
-        setUserPreferences(o.prefs).
-        setPerfLoggingPrefs(o.perfLoggingPrefs);
+    return options;
   }
 
-  if (capabilities.has(webdriver.Capability.PROXY)) {
-    options.setProxy(capabilities.get(webdriver.Capability.PROXY));
+  /**
+   * Add additional command line arguments to use when launching the Chrome
+   * browser.  Each argument may be specified with or without the "--" prefix
+   * (e.g. "--foo" and "foo"). Arguments with an associated value should be
+   * delimited by an "=": "foo=bar".
+   * @param {...(string|!Array<string>)} var_args The arguments to add.
+   * @return {!Options} A self reference.
+   */
+  addArguments(var_args) {
+    let args = this.options_.args || [];
+    args = args.concat.apply(args, arguments);
+    if (args.length) {
+      this.options_.args = args;
+    }
+    return this;
   }
 
-  if (capabilities.has(webdriver.Capability.LOGGING_PREFS)) {
-    options.setLoggingPrefs(
-        capabilities.get(webdriver.Capability.LOGGING_PREFS));
+  /**
+   * List of Chrome command line switches to exclude that ChromeDriver by default
+   * passes when starting Chrome.  Do not prefix switches with "--".
+   *
+   * @param {...(string|!Array<string>)} var_args The switches to exclude.
+   * @return {!Options} A self reference.
+   */
+  excludeSwitches(var_args) {
+    let switches = this.options_.excludeSwitches || [];
+    switches = switches.concat.apply(switches, arguments);
+    if (switches.length) {
+      this.options_.excludeSwitches = switches;
+    }
+    return this;
   }
 
-  return options;
-};
-
-
-/**
- * Add additional command line arguments to use when launching the Chrome
- * browser.  Each argument may be specified with or without the "--" prefix
- * (e.g. "--foo" and "foo"). Arguments with an associated value should be
- * delimited by an "=": "foo=bar".
- * @param {...(string|!Array.<string>)} var_args The arguments to add.
- * @return {!Options} A self reference.
- */
-Options.prototype.addArguments = function(var_args) {
-  var args = this.options_.args || [];
-  args = args.concat.apply(args, arguments);
-  if (args.length) {
-    this.options_.args = args;
+  /**
+   * Add additional extensions to install when launching Chrome. Each extension
+   * should be specified as the path to the packed CRX file, or a Buffer for an
+   * extension.
+   * @param {...(string|!Buffer|!Array<(string|!Buffer)>)} var_args The
+   *     extensions to add.
+   * @return {!Options} A self reference.
+   */
+  addExtensions(var_args) {
+    this.extensions_ =
+        this.extensions_.concat.apply(this.extensions_, arguments);
+    return this;
   }
-  return this;
-};
-
 
-/**
- * List of Chrome command line switches to exclude that ChromeDriver by default
- * passes when starting Chrome.  Do not prefix switches with "--".
- *
- * @param {...(string|!Array<string>)} var_args The switches to exclude.
- * @return {!Options} A self reference.
- */
-Options.prototype.excludeSwitches = function(var_args) {
-  var switches = this.options_.excludeSwitches || [];
-  switches = switches.concat.apply(switches, arguments);
-  if (switches.length) {
-    this.options_.excludeSwitches = switches;
+  /**
+   * Sets the path to the Chrome binary to use. On Mac OS X, this path should
+   * reference the actual Chrome executable, not just the application binary
+   * (e.g. "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome").
+   *
+   * The binary path be absolute or relative to the chromedriver server
+   * executable, but it must exist on the machine that will launch Chrome.
+   *
+   * @param {string} path The path to the Chrome binary to use.
+   * @return {!Options} A self reference.
+   */
+  setChromeBinaryPath(path) {
+    this.options_.binary = path;
+    return this;
   }
-  return this;
-};
-
-
-/**
- * Add additional extensions to install when launching Chrome. Each extension
- * should be specified as the path to the packed CRX file, or a Buffer for an
- * extension.
- * @param {...(string|!Buffer|!Array.<(string|!Buffer)>)} var_args The
- *     extensions to add.
- * @return {!Options} A self reference.
- */
-Options.prototype.addExtensions = function(var_args) {
-  this.extensions_ = this.extensions_.concat.apply(this.extensions_, arguments);
-  return this;
-};
-
-
-/**
- * Sets the path to the Chrome binary to use. On Mac OS X, this path should
- * reference the actual Chrome executable, not just the application binary
- * (e.g. "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome").
- *
- * The binary path be absolute or relative to the chromedriver server
- * executable, but it must exist on the machine that will launch Chrome.
- *
- * @param {string} path The path to the Chrome binary to use.
- * @return {!Options} A self reference.
- */
-Options.prototype.setChromeBinaryPath = function(path) {
-  this.options_.binary = path;
-  return this;
-};
-
-
-/**
- * Sets whether to leave the started Chrome browser running if the controlling
- * ChromeDriver service is killed before {@link webdriver.WebDriver#quit()} is
- * called.
- * @param {boolean} detach Whether to leave the browser running if the
- *     chromedriver service is killed before the session.
- * @return {!Options} A self reference.
- */
-Options.prototype.detachDriver = function(detach) {
-  this.options_.detach = detach;
-  return this;
-};
-
-
-/**
- * Sets the user preferences for Chrome's user profile. See the "Preferences"
- * file in Chrome's user data directory for examples.
- * @param {!Object} prefs Dictionary of user preferences to use.
- * @return {!Options} A self reference.
- */
-Options.prototype.setUserPreferences = function(prefs) {
-  this.options_.prefs = prefs;
-  return this;
-};
-
-
-/**
- * Sets the logging preferences for the new session.
- * @param {!webdriver.logging.Preferences} prefs The logging preferences.
- * @return {!Options} A self reference.
- */
-Options.prototype.setLoggingPrefs = function(prefs) {
-  this.logPrefs_ = prefs;
-  return this;
-};
-
-
-/**
- * Sets the performance logging preferences. Options include:
- *
- * - `enableNetwork`: Whether or not to collect events from Network domain.
- * - `enablePage`: Whether or not to collect events from Page domain.
- * - `enableTimeline`: Whether or not to collect events from Timeline domain.
- *     Note: when tracing is enabled, Timeline domain is implicitly disabled,
- *     unless `enableTimeline` is explicitly set to true.
- * - `tracingCategories`: A comma-separated string of Chrome tracing categories
- *     for which trace events should be collected. An unspecified or empty
- *     string disables tracing.
- * - `bufferUsageReportingInterval`: The requested number of milliseconds
- *     between DevTools trace buffer usage events. For example, if 1000, then
- *     once per second, DevTools will report how full the trace buffer is. If a
- *     report indicates the buffer usage is 100%, a warning will be issued.
- *
- * @param {{enableNetwork: boolean,
- *          enablePage: boolean,
- *          enableTimeline: boolean,
- *          tracingCategories: string,
- *          bufferUsageReportingInterval: number}} prefs The performance
- *     logging preferences.
- * @return {!Options} A self reference.
- */
-Options.prototype.setPerfLoggingPrefs = function(prefs) {
-  this.options_.perfLoggingPrefs = prefs;
-  return this;
-};
-
-
-/**
- * Sets preferences for the "Local State" file in Chrome's user data
- * directory.
- * @param {!Object} state Dictionary of local state preferences.
- * @return {!Options} A self reference.
- */
-Options.prototype.setLocalState = function(state) {
-  this.options_.localState = state;
-  return this;
-};
-
-
-/**
- * Sets the name of the activity hosting a Chrome-based Android WebView. This
- * option must be set to connect to an [Android WebView](
- * https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android)
- *
- * @param {string} name The activity name.
- * @return {!Options} A self reference.
- */
-Options.prototype.androidActivity = function(name) {
-  this.options_.androidActivity = name;
-  return this;
-};
-
-
-/**
- * Sets the device serial number to connect to via ADB. If not specified, the
- * ChromeDriver will select an unused device at random. An error will be
- * returned if all devices already have active sessions.
- *
- * @param {string} serial The device serial number to connect to.
- * @return {!Options} A self reference.
- */
-Options.prototype.androidDeviceSerial = function(serial) {
-  this.options_.androidDeviceSerial = serial;
-  return this;
-};
-
-
-/**
- * Configures the ChromeDriver to launch Chrome on Android via adb. This
- * function is shorthand for
- * {@link #androidPackage options.androidPackage('com.android.chrome')}.
- * @return {!Options} A self reference.
- */
-Options.prototype.androidChrome = function() {
-  return this.androidPackage('com.android.chrome');
-};
-
-
-/**
- * Sets the package name of the Chrome or WebView app.
- *
- * @param {?string} pkg The package to connect to, or `null` to disable Android
- *     and switch back to using desktop Chrome.
- * @return {!Options} A self reference.
- */
-Options.prototype.androidPackage = function(pkg) {
-  this.options_.androidPackage = pkg;
-  return this;
-};
 
+  /**
+   * Sets whether to leave the started Chrome browser running if the controlling
+   * ChromeDriver service is killed before {@link webdriver.WebDriver#quit()} is
+   * called.
+   * @param {boolean} detach Whether to leave the browser running if the
+   *     chromedriver service is killed before the session.
+   * @return {!Options} A self reference.
+   */
+  detachDriver(detach) {
+    this.options_.detach = detach;
+    return this;
+  }
 
-/**
- * Sets the process name of the Activity hosting the WebView (as given by `ps`).
- * If not specified, the process name is assumed to be the same as
- * {@link #androidPackage}.
- *
- * @param {string} processName The main activity name.
- * @return {!Options} A self reference.
- */
-Options.prototype.androidProcess = function(processName) {
-  this.options_.androidProcess = processName;
-  return this;
-};
+  /**
+   * Sets the user preferences for Chrome's user profile. See the "Preferences"
+   * file in Chrome's user data directory for examples.
+   * @param {!Object} prefs Dictionary of user preferences to use.
+   * @return {!Options} A self reference.
+   */
+  setUserPreferences(prefs) {
+    this.options_.prefs = prefs;
+    return this;
+  }
 
+  /**
+   * Sets the logging preferences for the new session.
+   * @param {!logging.Preferences} prefs The logging preferences.
+   * @return {!Options} A self reference.
+   */
+  setLoggingPrefs(prefs) {
+    this.logPrefs_ = prefs;
+    return this;
+  }
 
-/**
- * Sets whether to connect to an already-running instead of the specified
- * {@linkplain #androidProcess app} instead of launching the app with a clean
- * data directory.
- *
- * @param {boolean} useRunning Whether to connect to a running instance.
- * @return {!Options} A self reference.
- */
-Options.prototype.androidUseRunningApp = function(useRunning) {
-  this.options_.androidUseRunningApp = useRunning;
-  return this;
-};
+  /**
+   * Sets the performance logging preferences. Options include:
+   *
+   * - `enableNetwork`: Whether or not to collect events from Network domain.
+   * - `enablePage`: Whether or not to collect events from Page domain.
+   * - `enableTimeline`: Whether or not to collect events from Timeline domain.
+   *     Note: when tracing is enabled, Timeline domain is implicitly disabled,
+   *     unless `enableTimeline` is explicitly set to true.
+   * - `tracingCategories`: A comma-separated string of Chrome tracing
+   *     categories for which trace events should be collected. An unspecified
+   *     or empty string disables tracing.
+   * - `bufferUsageReportingInterval`: The requested number of milliseconds
+   *     between DevTools trace buffer usage events. For example, if 1000, then
+   *     once per second, DevTools will report how full the trace buffer is. If
+   *     a report indicates the buffer usage is 100%, a warning will be issued.
+   *
+   * @param {{enableNetwork: boolean,
+   *          enablePage: boolean,
+   *          enableTimeline: boolean,
+   *          tracingCategories: string,
+   *          bufferUsageReportingInterval: number}} prefs The performance
+   *     logging preferences.
+   * @return {!Options} A self reference.
+   */
+  setPerfLoggingPrefs(prefs) {
+    this.options_.perfLoggingPrefs = prefs;
+    return this;
+  }
 
+  /**
+   * Sets preferences for the "Local State" file in Chrome's user data
+   * directory.
+   * @param {!Object} state Dictionary of local state preferences.
+   * @return {!Options} A self reference.
+   */
+  setLocalState(state) {
+    this.options_.localState = state;
+    return this;
+  }
 
-/**
- * Sets the path to Chrome's log file. This path should exist on the machine
- * that will launch Chrome.
- * @param {string} path Path to the log file to use.
- * @return {!Options} A self reference.
- */
-Options.prototype.setChromeLogFile = function(path) {
-  this.options_.logPath = path;
-  return this;
-};
+  /**
+   * Sets the name of the activity hosting a Chrome-based Android WebView. This
+   * option must be set to connect to an [Android WebView](
+   * https://sites.google.com/a/chromium.org/chromedriver/getting-started/getting-started---android)
+   *
+   * @param {string} name The activity name.
+   * @return {!Options} A self reference.
+   */
+  androidActivity(name) {
+    this.options_.androidActivity = name;
+    return this;
+  }
 
+  /**
+   * Sets the device serial number to connect to via ADB. If not specified, the
+   * ChromeDriver will select an unused device at random. An error will be
+   * returned if all devices already have active sessions.
+   *
+   * @param {string} serial The device serial number to connect to.
+   * @return {!Options} A self reference.
+   */
+  androidDeviceSerial(serial) {
+    this.options_.androidDeviceSerial = serial;
+    return this;
+  }
 
-/**
- * Sets the directory to store Chrome minidumps in. This option is only
- * supported when ChromeDriver is running on Linux.
- * @param {string} path The directory path.
- * @return {!Options} A self reference.
- */
-Options.prototype.setChromeMinidumpPath = function(path) {
-  this.options_.minidumpPath = path;
-  return this;
-};
+  /**
+   * Configures the ChromeDriver to launch Chrome on Android via adb. This
+   * function is shorthand for
+   * {@link #androidPackage options.androidPackage('com.android.chrome')}.
+   * @return {!Options} A self reference.
+   */
+  androidChrome() {
+    return this.androidPackage('com.android.chrome');
+  }
 
+  /**
+   * Sets the package name of the Chrome or WebView app.
+   *
+   * @param {?string} pkg The package to connect to, or `null` to disable Android
+   *     and switch back to using desktop Chrome.
+   * @return {!Options} A self reference.
+   */
+  androidPackage(pkg) {
+    this.options_.androidPackage = pkg;
+    return this;
+  }
 
-/**
- * Configures Chrome to emulate a mobile device. For more information, refer to
- * the ChromeDriver project page on [mobile emulation][em]. Configuration
- * options include:
- *
- * - `deviceName`: The name of a pre-configured [emulated device][devem]
- * - `width`: screen width, in pixels
- * - `height`: screen height, in pixels
- * - `pixelRatio`: screen pixel ratio
- *
- * __Example 1: Using a Pre-configured Device__
- *
- *     var options = new chrome.Options().setMobileEmulation(
- *         {deviceName: 'Google Nexus 5'});
- *
- *     var driver = new chrome.Driver(options);
- *
- * __Example 2: Using Custom Screen Configuration__
- *
- *     var options = new chrome.Options().setMobileEmulation({
- *         width: 360,
- *         height: 640,
- *         pixelRatio: 3.0
- *     });
- *
- *     var driver = new chrome.Driver(options);
- *
- *
- * [em]: https://sites.google.com/a/chromium.org/chromedriver/mobile-emulation
- * [devem]: https://developer.chrome.com/devtools/docs/device-mode
- *
- * @param {?({deviceName: string}|
- *           {width: number, height: number, pixelRatio: number})} config The
- *     mobile emulation configuration, or `null` to disable emulation.
- * @return {!Options} A self reference.
- */
-Options.prototype.setMobileEmulation = function(config) {
-  this.options_.mobileEmulation = config;
-  return this;
-};
+  /**
+   * Sets the process name of the Activity hosting the WebView (as given by
+   * `ps`). If not specified, the process name is assumed to be the same as
+   * {@link #androidPackage}.
+   *
+   * @param {string} processName The main activity name.
+   * @return {!Options} A self reference.
+   */
+  androidProcess(processName) {
+    this.options_.androidProcess = processName;
+    return this;
+  }
 
+  /**
+   * Sets whether to connect to an already-running instead of the specified
+   * {@linkplain #androidProcess app} instead of launching the app with a clean
+   * data directory.
+   *
+   * @param {boolean} useRunning Whether to connect to a running instance.
+   * @return {!Options} A self reference.
+   */
+  androidUseRunningApp(useRunning) {
+    this.options_.androidUseRunningApp = useRunning;
+    return this;
+  }
 
-/**
- * Sets the proxy settings for the new session.
- * @param {webdriver.ProxyConfig} proxy The proxy configuration to use.
- * @return {!Options} A self reference.
- */
-Options.prototype.setProxy = function(proxy) {
-  this.proxy_ = proxy;
-  return this;
-};
+  /**
+   * Sets the path to Chrome's log file. This path should exist on the machine
+   * that will launch Chrome.
+   * @param {string} path Path to the log file to use.
+   * @return {!Options} A self reference.
+   */
+  setChromeLogFile(path) {
+    this.options_.logPath = path;
+    return this;
+  }
 
+  /**
+   * Sets the directory to store Chrome minidumps in. This option is only
+   * supported when ChromeDriver is running on Linux.
+   * @param {string} path The directory path.
+   * @return {!Options} A self reference.
+   */
+  setChromeMinidumpPath(path) {
+    this.options_.minidumpPath = path;
+    return this;
+  }
 
-/**
- * Converts this options instance to a {@link webdriver.Capabilities} object.
- * @param {webdriver.Capabilities=} opt_capabilities The capabilities to merge
- *     these options into, if any.
- * @return {!webdriver.Capabilities} The capabilities.
- */
-Options.prototype.toCapabilities = function(opt_capabilities) {
-  var capabilities = opt_capabilities || webdriver.Capabilities.chrome();
-  capabilities.
-      set(webdriver.Capability.PROXY, this.proxy_).
-      set(webdriver.Capability.LOGGING_PREFS, this.logPrefs_).
-      set(OPTIONS_CAPABILITY_KEY, this);
-  return capabilities;
-};
+  /**
+   * Configures Chrome to emulate a mobile device. For more information, refer
+   * to the ChromeDriver project page on [mobile emulation][em]. Configuration
+   * options include:
+   *
+   * - `deviceName`: The name of a pre-configured [emulated device][devem]
+   * - `width`: screen width, in pixels
+   * - `height`: screen height, in pixels
+   * - `pixelRatio`: screen pixel ratio
+   *
+   * __Example 1: Using a Pre-configured Device__
+   *
+   *     let options = new chrome.Options().setMobileEmulation(
+   *         {deviceName: 'Google Nexus 5'});
+   *
+   *     let driver = new chrome.Driver(options);
+   *
+   * __Example 2: Using Custom Screen Configuration__
+   *
+   *     let options = new chrome.Options().setMobileEmulation({
+   *         width: 360,
+   *         height: 640,
+   *         pixelRatio: 3.0
+   *     });
+   *
+   *     let driver = new chrome.Driver(options);
+   *
+   *
+   * [em]: https://sites.google.com/a/chromium.org/chromedriver/mobile-emulation
+   * [devem]: https://developer.chrome.com/devtools/docs/device-mode
+   *
+   * @param {?({deviceName: string}|
+   *           {width: number, height: number, pixelRatio: number})} config The
+   *     mobile emulation configuration, or `null` to disable emulation.
+   * @return {!Options} A self reference.
+   */
+  setMobileEmulation(config) {
+    this.options_.mobileEmulation = config;
+    return this;
+  }
 
+  /**
+   * Sets the proxy settings for the new session.
+   * @param {./lib/capabilities.ProxyConfig} proxy The proxy configuration to
+   *    use.
+   * @return {!Options} A self reference.
+   */
+  setProxy(proxy) {
+    this.proxy_ = proxy;
+    return this;
+  }
 
-/**
- * Converts this instance to its JSON wire protocol representation. Note this
- * function is an implementation not intended for general use.
- * @return {{args: !Array.<string>,
- *           binary: (string|undefined),
- *           detach: boolean,
- *           extensions: !Array.<(string|!webdriver.promise.Promise.<string>)>,
- *           localState: (Object|undefined),
- *           logPath: (string|undefined),
- *           prefs: (Object|undefined)}} The JSON wire protocol representation
- *     of this instance.
- * @override
- */
-Options.prototype.serialize = function() {
-  var json = {};
-  for (var key in this.options_) {
-    if (this.options_[key] != null) {
-      json[key] = this.options_[key];
-    }
+  /**
+   * Converts this options instance to a {@link Capabilities} object.
+   * @param {Capabilities=} opt_capabilities The capabilities to merge
+   *     these options into, if any.
+   * @return {!Capabilities} The capabilities.
+   */
+  toCapabilities(opt_capabilities) {
+    let caps = opt_capabilities || Capabilities.chrome();
+    caps.
+        set(Capability.PROXY, this.proxy_).
+        set(Capability.LOGGING_PREFS, this.logPrefs_).
+        set(OPTIONS_CAPABILITY_KEY, this);
+    return caps;
   }
-  if (this.extensions_.length) {
-    json.extensions = this.extensions_.map(function(extension) {
-      if (Buffer.isBuffer(extension)) {
-        return extension.toString('base64');
+
+  /**
+   * Converts this instance to its JSON wire protocol representation. Note this
+   * function is an implementation not intended for general use.
+   * @return {!Object} The JSON wire protocol representation of this instance.
+   */
+  [Symbols.serialize]() {
+    let json = {};
+    for (let key in this.options_) {
+      if (this.options_[key] != null) {
+        json[key] = this.options_[key];
       }
-      return webdriver.promise.checkedNodeCall(
-          fs.readFile, extension, 'base64');
-    });
+    }
+    if (this.extensions_.length) {
+      json.extensions = this.extensions_.map(function(extension) {
+        if (Buffer.isBuffer(extension)) {
+          return extension.toString('base64');
+        }
+        return promise.checkedNodeCall(
+            fs.readFile, extension, 'base64');
+      });
+    }
+    return json;
   }
-  return json;
-};
+}
 
 
 /**
  * Creates a new WebDriver client for Chrome.
- *
- * @param {(webdriver.Capabilities|Options)=} opt_config The configuration
- *     options.
- * @param {remote.DriverService=} opt_service The session to use; will use
- *     the {@linkplain #getDefaultService default service} by default.
- * @param {webdriver.promise.ControlFlow=} opt_flow The control flow to use, or
- *     {@code null} to use the currently active flow.
- * @constructor
- * @extends {webdriver.WebDriver}
- */
-var Driver = function(opt_config, opt_service, opt_flow) {
-  var service = opt_service || getDefaultService();
-  var executor = createExecutor(service.start());
-
-  var capabilities =
-      opt_config instanceof Options ? opt_config.toCapabilities() :
-      (opt_config || webdriver.Capabilities.chrome());
-
-  var driver = webdriver.WebDriver.createSession(
-      executor, capabilities, opt_flow);
-
-  webdriver.WebDriver.call(
-      this, driver.getSession(), executor, driver.controlFlow());
-};
-util.inherits(Driver, webdriver.WebDriver);
-
-
-/**
- * This function is a no-op as file detectors are not supported by this
- * implementation.
- * @override
  */
-Driver.prototype.setFileDetector = function() {
-};
-
+class Driver extends webdriver.WebDriver {
+  /**
+   * @param {(Capabilities|Options)=} opt_config The configuration
+   *     options.
+   * @param {remote.DriverService=} opt_service The session to use; will use
+   *     the {@linkplain #getDefaultService default service} by default.
+   * @param {promise.ControlFlow=} opt_flow The control flow to use,
+   *     or {@code null} to use the currently active flow.
+   */
+  constructor(opt_config, opt_service, opt_flow) {
+    let service = opt_service || getDefaultService();
+    let executor = createExecutor(service.start());
+
+    let caps =
+        opt_config instanceof Options ? opt_config.toCapabilities() :
+        (opt_config || Capabilities.chrome());
+
+    let driver = webdriver.WebDriver.createSession(executor, caps, opt_flow);
+
+    super(driver.getSession(), executor, driver.controlFlow());
+  }
 
-/**
- * Schedules a command to launch Chrome App with given ID.
- * @param {string} id ID of the App to launch.
- * @return {!webdriver.promise.Promise<void>} A promise that will be resolved
- *     when app is launched.
- */
-Driver.prototype.launchApp = function(id) {
-  return this.schedule(
-      new webdriver.Command(Command.LAUNCH_APP).setParameter('id', id),
-      'Driver.launchApp()');
-};
+  /**
+   * This function is a no-op as file detectors are not supported by this
+   * implementation.
+   * @override
+   */
+  setFileDetector() {}
+
+  /**
+   * Schedules a command to launch Chrome App with given ID.
+   * @param {string} id ID of the App to launch.
+   * @return {!promise.Promise<void>} A promise that will be resolved
+   *     when app is launched.
+   */
+  launchApp(id) {
+    return this.schedule(
+        new command.Command(Command.LAUNCH_APP).setParameter('id', id),
+        'Driver.launchApp()');
+  }
+}
 
 
 // PUBLIC API