Class Options

Add additional command line arguments to use when launching the Edge 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'.

Add additional extensions to install when launching Edge. Each extension should be specified as the path to the packed CRX file, or a Buffer for an extension.

Sets the name of the activity hosting a Edge-based Android WebView. This option must be set to connect to an Android WebView

Sets the device serial number to connect to via ADB. If not specified, the EdgeDriver will select an unused device at random. An error will be returned if all devices already have active sessions.

Configures the EdgeDriver to launch Edge on Android via adb. This function is shorthand for #androidPackage options.androidPackage('com.android.edge').

Sets the package name of the Edge or WebView app.

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 #androidPackage.

Sets whether to connect to an already-running instead of the specified #androidProcess app instead of launching the app with a clean data directory.

Sets whether to leave the started Edge browser running if the controlling EdgeDriver service is killed before () is called.

List of Edge command line switches to exclude that EdgeDriver by default passes when starting Edge. Do not prefix switches with '--'.

Configures the edgedriver to start Edge in headless mode.

NOTE: Resizing the browser window in headless mode is only supported in Edge 60. Users are encouraged to set an initial window size with the #windowSize windowSize({width, height)} option.

Sets the path to the Edge binary to use. On Mac OS X, this path should reference the actual Edge executable, not just the application binary (e.g. '/Applications/Google Edge.app/Contents/MacOS/Google Edge').

The binary path be absolute or relative to the edgedriver server executable, but it must exist on the machine that will launch Edge.

Sets the path to the edge binary to use

The binary path be absolute or relative to the msedgedriver server executable, but it must exist on the machine that will launch edge chromium.

Sets the path to Edge's log file. This path should exist on the machine that will launch Edge.

Sets the directory to store Edge minidumps in. This option is only supported when EdgeDriver is running on Linux.

Sets preferences for the 'Local State' file in Edge's user data directory.

Configures Edge to emulate a mobile device. For more information, refer to the EdgeDriver project page on mobile emulation. Configuration options include:

• deviceName: The name of a pre-configured emulated device
• width: screen width, in pixels
• height: screen height, in pixels
• pixelRatio: screen pixel ratio

Example 1: Using a Pre-configured Device

let options = new edge.Options().setMobileEmulation(
    {deviceName: 'Google Nexus 5'});

let driver = new edge.Driver(options);
Copy

Example 2: Using Custom Screen Configuration

let options = new edge.Options().setMobileEmulation({
    width: 360,
    height: 640,
    pixelRatio: 3.0
});

let driver = new edge.Driver(options);
Copy

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 Edge 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.

Sets the user preferences for Edge's user profile. See the 'Preferences' file in Edge's user data directory for examples.

Sets the initial window size.

Throws

if width or height is unspecified, not a number, or less than or equal to 0.

Extracts the EdgeDriver specific options from the given capabilities object.