MORPH
SIGN IN SIGN UP
SeleniumHQ / selenium UNCLAIMED

A browser automation framework and ecosystem.

34196 0 49 Java
Normal View History Raw
Update copyright notices for the javascript/ tree for #401. I still need to update selenium-core - lots of files in there that need manual review.
2015-04-04 09:53:59 -07:00
// 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
Roll back addition of @license tag to all JS files. This bloats the atoms considerably with no benefit.
2014-11-12 19:33:37 +00:00
//
Update copyright notices for the javascript/ tree for #401. I still need to update selenium-core - lots of files in there that need manual review.
2015-04-04 09:53:59 -07:00
// http://www.apache.org/licenses/LICENSE-2.0
Roll back addition of @license tag to all JS files. This bloats the atoms considerably with no benefit.
2014-11-12 19:33:37 +00:00
//
Update copyright notices for the javascript/ tree for #401. I still need to update selenium-core - lots of files in there that need manual review.
2015-04-04 09:53:59 -07:00
// 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.
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
/**
* @fileoverview Defines the webdriver.Capabilities class.
*/
goog.provide('webdriver.Browser');
goog.provide('webdriver.Capabilities');
Syncing js changes, primarily refinements to visibility/overflow computations. This change makes two java changes to support running JS tests: - Restrict the window size when running JS tests as this matters for a lot of the overflow tests and not every browser supports window.resizeTo - When launching Opera, ensure geolocation is enabled by default
2013-08-16 11:53:17 -07:00
goog.provide('webdriver.Capability');
* Add more options to the Builder API (every common, settable capability should be covered). * Require calling Builder.usingServer(url) to use a remote server. If this is not called, the builder will attempt to create a client locally, throwing an error if it can't (e.g. for IE). * Add browser specific constructors to simplify creating a client without the Builder. Fixes issue 7593
2014-08-20 21:09:18 -07:00
goog.provide('webdriver.ProxyConfig');
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
js: convert `webdriver.logging` to closure module syntax.
2015-04-19 09:04:54 -07:00
goog.require('webdriver.logging');
Explicitly goog.require a used dependency
2014-09-11 03:45:33 -07:00
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
/**
* Recognized browser names.
* @enum {string}
[bazel]: compile fragments needed by w3c drivers
2018-11-25 15:31:54 +00:00
* @suppress {lintChecks}
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
*/
webdriver.Browser = {
ANDROID: 'android',
CHROME: 'chrome',
FIREFOX: 'firefox',
Add native support for IE to WebDriverJS
2015-02-21 09:59:24 -08:00
IE: 'internet explorer',
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
INTERNET_EXPLORER: 'internet explorer',
Add JS bindings for Microsoft's Edge browser Add a base set of capabilities for Microsoft's Edge browser Add 'EDGE' property to webdriver.Browser object. Add 'edge' method to webdriver.Capabilities object. Add edge.js to javascript/node/selenium-webdriver directory Add Edge-specific Options class Add Edge-specific ServiceBuilder class Add an Edge-specific ServiceBuilder class that manages the Edge WebDriver server in a child process. Add a WebDriver client for Microsoft's Edge browser Add license header to edge.js Add Edge-specific properties and methods to the Builder class * Create WebDriver client when the Edge browser is specified. * Add edgeOptions property and setEdgeOptions method. Update README.md & CHANGES.md Signed-off-by: Jason Leyba <jmleyba@gmail.com>
2016-01-07 16:52:18 -08:00
EDGE: 'MicrosoftEdge',
Makes default capabilities sets minimally consistent for all bindings. What's done: 1. C# binding * fix htmlunitwithjs caps * fix platform for chrome caps 2. java binding: * add htmlunitwithjs caps 3. javascript binding: * fix ipad, iphone browser names * add htmlunit, htmlunitwithjs caps 4. Python binding: * fix platform for safari caps 5. Ruby binding: * adds htmlunitwithjs caps
2013-10-03 20:57:26 +04:00
IPAD: 'iPad',
IPHONE: 'iPhone',
Restore ability to select Opera in webdriverjs capabilities (accidentally removed in revision af8b8eedf016). WebDriverJS only supports Chromium-based Opera (26+), not Presto
2015-02-28 13:07:36 -08:00
OPERA: 'opera',
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
PHANTOM_JS: 'phantomjs',
Makes default capabilities sets minimally consistent for all bindings. What's done: 1. C# binding * fix htmlunitwithjs caps * fix platform for chrome caps 2. java binding: * add htmlunitwithjs caps 3. javascript binding: * fix ipad, iphone browser names * add htmlunit, htmlunitwithjs caps 4. Python binding: * fix platform for safari caps 5. Ruby binding: * adds htmlunitwithjs caps
2013-10-03 20:57:26 +04:00
SAFARI: 'safari',
HTMLUNIT: 'htmlunit'
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
};
* Add more options to the Builder API (every common, settable capability should be covered). * Require calling Builder.usingServer(url) to use a remote server. If this is not called, the builder will attempt to create a client locally, throwing an error if it can't (e.g. for IE). * Add browser specific constructors to simplify creating a client without the Builder. Fixes issue 7593
2014-08-20 21:09:18 -07:00
/**
* Describes how a proxy should be configured for a WebDriver session.
* Proxy configuration object, as defined by the WebDriver wire protocol.
* @typedef {(
* {proxyType: string}|
* {proxyType: string,
* proxyAutoconfigUrl: string}|
* {proxyType: string,
* ftpProxy: string,
* httpProxy: string,
* sslProxy: string,
* noProxy: string})}
*/
webdriver.ProxyConfig;
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
/**
* Common webdriver capability keys.
* @enum {string}
*/
webdriver.Capability = {
/**
* Indicates whether a driver should accept all SSL certs by default. This
* capability only applies when requesting a new session. To query whether
Cleaning up docs. No functional changes.
2015-02-15 20:16:33 -08:00
* a driver can handle insecure SSL certs, see {@link #SECURE_SSL}.
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
*/
ACCEPT_SSL_CERTS: 'acceptSslCerts',
/**
* The browser name. Common browser names are defined in the
* {@link webdriver.Browser} enum.
*/
BROWSER_NAME: 'browserName',
* Add more options to the Builder API (every common, settable capability should be covered). * Require calling Builder.usingServer(url) to use a remote server. If this is not called, the builder will attempt to create a client locally, throwing an error if it can't (e.g. for IE). * Add browser specific constructors to simplify creating a client without the Builder. Fixes issue 7593
2014-08-20 21:09:18 -07:00
/**
* Defines how elements should be scrolled into the viewport for interaction.
* This capability will be set to zero (0) if elements are aligned with the
* top of the viewport, or one (1) if aligned with the bottom. The default
* behavior is to align with the top of the viewport.
*/
ELEMENT_SCROLL_BEHAVIOR: 'elementScrollBehavior',
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
/**
* Whether the driver is capable of handling modal alerts (e.g. alert,
* confirm, prompt). To define how a driver <i>should</i> handle alerts,
Cleaning up docs. No functional changes.
2015-02-15 20:16:33 -08:00
* use {@link #UNEXPECTED_ALERT_BEHAVIOR}.
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
*/
HANDLES_ALERTS: 'handlesAlerts',
/**
* Key for the logging driver logging preferences.
*/
LOGGING_PREFS: 'loggingPrefs',
* Add more options to the Builder API (every common, settable capability should be covered). * Require calling Builder.usingServer(url) to use a remote server. If this is not called, the builder will attempt to create a client locally, throwing an error if it can't (e.g. for IE). * Add browser specific constructors to simplify creating a client without the Builder. Fixes issue 7593
2014-08-20 21:09:18 -07:00
/**
* Whether this session generates native events when simulating user input.
*/
NATIVE_EVENTS: 'nativeEvents',
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
/**
* Describes the platform the browser is running on. Will be one of
* ANDROID, IOS, LINUX, MAC, UNIX, or WINDOWS. When <i>requesting</i> a
* session, ANY may be used to indicate no platform preference (this is
* semantically equivalent to omitting the platform capability).
*/
PLATFORM: 'platform',
Add proxy support to the builder
2013-06-26 22:16:09 -07:00
/**
* Describes the proxy configuration to use for a new WebDriver session.
*/
PROXY: 'proxy',
[JS] Minor typo fixes (#8631)
2020-08-16 00:03:35 +05:30
/** Whether the driver supports changing the browser's orientation. */
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
ROTATABLE: 'rotatable',
/**
* Whether a driver is only capable of handling secure SSL certs. To request
* that a driver accept insecure SSL certs by default, use
Cleaning up docs. No functional changes.
2015-02-15 20:16:33 -08:00
* {@link #ACCEPT_SSL_CERTS}.
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
*/
SECURE_SSL: 'secureSsl',
/** Whether the driver supports manipulating the app cache. */
SUPPORTS_APPLICATION_CACHE: 'applicationCacheEnabled',
/** Whether the driver supports locating elements with CSS selectors. */
SUPPORTS_CSS_SELECTORS: 'cssSelectorsEnabled',
/** Whether the browser supports JavaScript. */
SUPPORTS_JAVASCRIPT: 'javascriptEnabled',
/** Whether the driver supports controlling the browser's location info. */
SUPPORTS_LOCATION_CONTEXT: 'locationContextEnabled',
/** Whether the driver supports taking screenshots. */
TAKES_SCREENSHOT: 'takesScreenshot',
/**
* Defines how the driver should handle unexpected alerts. The value should
* be one of "accept", "dismiss", or "ignore.
*/
UNEXPECTED_ALERT_BEHAVIOR: 'unexpectedAlertBehavior',
/** Defines the browser version. */
VERSION: 'version'
};
/**
Add native ChromeDriver support to WebDriverJs.
2013-06-23 20:19:52 -07:00
* @param {(webdriver.Capabilities|Object)=} opt_other Another set of
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
* capabilities to merge into this instance.
* @constructor
*/
webdriver.Capabilities = function(opt_other) {
Introduce a new serializable type. This is used for types that cannot be synchronously converted to their JSON wire format (synchronous types may continue using the standard toJSON() function)
2014-10-30 11:14:52 -07:00
/** @private {!Object.<string, ?>} */
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
this.caps_ = {};
if (opt_other) {
this.merge(opt_other);
}
};
/**
Ensure the webdriver.Capabilities class is properly converted to JSON.
2013-06-23 10:05:45 -07:00
* @return {!webdriver.Capabilities} A basic set of capabilities for Android.
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
*/
webdriver.Capabilities.android = function() {
return new webdriver.Capabilities().
set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.ANDROID).
set(webdriver.Capability.PLATFORM, 'ANDROID');
};
/**
Ensure the webdriver.Capabilities class is properly converted to JSON.
2013-06-23 10:05:45 -07:00
* @return {!webdriver.Capabilities} A basic set of capabilities for Chrome.
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
*/
webdriver.Capabilities.chrome = function() {
return new webdriver.Capabilities().
set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.CHROME);
};
/**
Ensure the webdriver.Capabilities class is properly converted to JSON.
2013-06-23 10:05:45 -07:00
* @return {!webdriver.Capabilities} A basic set of capabilities for Firefox.
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
*/
webdriver.Capabilities.firefox = function() {
return new webdriver.Capabilities().
set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.FIREFOX);
};
/**
Ensure the webdriver.Capabilities class is properly converted to JSON.
2013-06-23 10:05:45 -07:00
* @return {!webdriver.Capabilities} A basic set of capabilities for
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
* Internet Explorer.
*/
webdriver.Capabilities.ie = function() {
return new webdriver.Capabilities().
set(webdriver.Capability.BROWSER_NAME,
webdriver.Browser.INTERNET_EXPLORER).
set(webdriver.Capability.PLATFORM, 'WINDOWS');
};
Add JS bindings for Microsoft's Edge browser Add a base set of capabilities for Microsoft's Edge browser Add 'EDGE' property to webdriver.Browser object. Add 'edge' method to webdriver.Capabilities object. Add edge.js to javascript/node/selenium-webdriver directory Add Edge-specific Options class Add Edge-specific ServiceBuilder class Add an Edge-specific ServiceBuilder class that manages the Edge WebDriver server in a child process. Add a WebDriver client for Microsoft's Edge browser Add license header to edge.js Add Edge-specific properties and methods to the Builder class * Create WebDriver client when the Edge browser is specified. * Add edgeOptions property and setEdgeOptions method. Update README.md & CHANGES.md Signed-off-by: Jason Leyba <jmleyba@gmail.com>
2016-01-07 16:52:18 -08:00
/**
* @return {!webdriver.Capabilities} A basic set of capabilities for
* Microsoft Edge.
*/
webdriver.Capabilities.edge = function() {
return new webdriver.Capabilities().
Fix capabilties to support macOS platform (#7980)
2020-01-31 01:42:06 +03:00
set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.EDGE);
Add JS bindings for Microsoft's Edge browser Add a base set of capabilities for Microsoft's Edge browser Add 'EDGE' property to webdriver.Browser object. Add 'edge' method to webdriver.Capabilities object. Add edge.js to javascript/node/selenium-webdriver directory Add Edge-specific Options class Add Edge-specific ServiceBuilder class Add an Edge-specific ServiceBuilder class that manages the Edge WebDriver server in a child process. Add a WebDriver client for Microsoft's Edge browser Add license header to edge.js Add Edge-specific properties and methods to the Builder class * Create WebDriver client when the Edge browser is specified. * Add edgeOptions property and setEdgeOptions method. Update README.md & CHANGES.md Signed-off-by: Jason Leyba <jmleyba@gmail.com>
2016-01-07 16:52:18 -08:00
};
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
/**
Ensure the webdriver.Capabilities class is properly converted to JSON.
2013-06-23 10:05:45 -07:00
* @return {!webdriver.Capabilities} A basic set of capabilities for iPad.
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
*/
webdriver.Capabilities.ipad = function() {
return new webdriver.Capabilities().
set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.IPAD).
set(webdriver.Capability.PLATFORM, 'MAC');
};
/**
Ensure the webdriver.Capabilities class is properly converted to JSON.
2013-06-23 10:05:45 -07:00
* @return {!webdriver.Capabilities} A basic set of capabilities for iPhone.
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
*/
webdriver.Capabilities.iphone = function() {
return new webdriver.Capabilities().
set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.IPHONE).
set(webdriver.Capability.PLATFORM, 'MAC');
};
Restore ability to select Opera in webdriverjs capabilities (accidentally removed in revision af8b8eedf016). WebDriverJS only supports Chromium-based Opera (26+), not Presto
2015-02-28 13:07:36 -08:00
/**
* @return {!webdriver.Capabilities} A basic set of capabilities for Opera.
*/
webdriver.Capabilities.opera = function() {
return new webdriver.Capabilities().
set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.OPERA);
};
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
/**
Ensure the webdriver.Capabilities class is properly converted to JSON.
2013-06-23 10:05:45 -07:00
* @return {!webdriver.Capabilities} A basic set of capabilities for
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
* PhantomJS.
*/
webdriver.Capabilities.phantomjs = function() {
return new webdriver.Capabilities().
set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.PHANTOM_JS);
};
/**
Ensure the webdriver.Capabilities class is properly converted to JSON.
2013-06-23 10:05:45 -07:00
* @return {!webdriver.Capabilities} A basic set of capabilities for Safari.
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
*/
webdriver.Capabilities.safari = function() {
return new webdriver.Capabilities().
Safari should only specify MAC as platform in default desired capabilities Fixes #1186
2015-10-22 09:32:41 -07:00
set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.SAFARI).
set(webdriver.Capability.PLATFORM, 'MAC');
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
};
pushing recent js changes. this is mostly lint clean-up with functional changes isolated to the bot.color module and how the FirefoxDriver generates key events. Signed-off-by: Jason Leyba <jmleyba@gmail.com>
2013-11-13 12:56:36 -08:00
Makes default capabilities sets minimally consistent for all bindings. What's done: 1. C# binding * fix htmlunitwithjs caps * fix platform for chrome caps 2. java binding: * add htmlunitwithjs caps 3. javascript binding: * fix ipad, iphone browser names * add htmlunit, htmlunitwithjs caps 4. Python binding: * fix platform for safari caps 5. Ruby binding: * adds htmlunitwithjs caps
2013-10-03 20:57:26 +04:00
/**
* @return {!webdriver.Capabilities} A basic set of capabilities for HTMLUnit.
*/
webdriver.Capabilities.htmlunit = function() {
return new webdriver.Capabilities().
set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.HTMLUNIT);
};
pushing recent js changes. this is mostly lint clean-up with functional changes isolated to the bot.color module and how the FirefoxDriver generates key events. Signed-off-by: Jason Leyba <jmleyba@gmail.com>
2013-11-13 12:56:36 -08:00
Makes default capabilities sets minimally consistent for all bindings. What's done: 1. C# binding * fix htmlunitwithjs caps * fix platform for chrome caps 2. java binding: * add htmlunitwithjs caps 3. javascript binding: * fix ipad, iphone browser names * add htmlunit, htmlunitwithjs caps 4. Python binding: * fix platform for safari caps 5. Ruby binding: * adds htmlunitwithjs caps
2013-10-03 20:57:26 +04:00
/**
* @return {!webdriver.Capabilities} A basic set of capabilities for HTMLUnit
pushing recent js changes. this is mostly lint clean-up with functional changes isolated to the bot.color module and how the FirefoxDriver generates key events. Signed-off-by: Jason Leyba <jmleyba@gmail.com>
2013-11-13 12:56:36 -08:00
* with enabled Javascript.
Makes default capabilities sets minimally consistent for all bindings. What's done: 1. C# binding * fix htmlunitwithjs caps * fix platform for chrome caps 2. java binding: * add htmlunitwithjs caps 3. javascript binding: * fix ipad, iphone browser names * add htmlunit, htmlunitwithjs caps 4. Python binding: * fix platform for safari caps 5. Ruby binding: * adds htmlunitwithjs caps
2013-10-03 20:57:26 +04:00
*/
webdriver.Capabilities.htmlunitwithjs = function() {
return new webdriver.Capabilities().
set(webdriver.Capability.BROWSER_NAME, webdriver.Browser.HTMLUNIT).
set(webdriver.Capability.SUPPORTS_JAVASCRIPT, true);
};
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
pushing recent js changes. this is mostly lint clean-up with functional changes isolated to the bot.color module and how the FirefoxDriver generates key events. Signed-off-by: Jason Leyba <jmleyba@gmail.com>
2013-11-13 12:56:36 -08:00
Introduce a new serializable type. This is used for types that cannot be synchronously converted to their JSON wire format (synchronous types may continue using the standard toJSON() function)
2014-10-30 11:14:52 -07:00
/**
* @return {!Object.<string, ?>} The JSON representation of this instance. Note,
* the returned object may contain nested promises that are promised values.
*/
webdriver.Capabilities.prototype.serialize = function() {
return this.caps_;
};
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
/**
* Merges another set of capabilities into this instance. Any duplicates in
* the provided set will override those already set on this instance.
* @param {!(webdriver.Capabilities|Object)} other The capabilities to
* merge into this instance.
* @return {!webdriver.Capabilities} A self reference.
*/
webdriver.Capabilities.prototype.merge = function(other) {
var caps = other instanceof webdriver.Capabilities ?
other.caps_ : other;
for (var key in caps) {
if (caps.hasOwnProperty(key)) {
this.set(key, caps[key]);
}
}
return this;
};
/**
* @param {string} key The capability to set.
* @param {*} value The capability value. Capability values must be JSON
[bazel]: compile fragments needed by w3c drivers
2018-11-25 15:31:54 +00:00
* serializable. Pass `null` to unset the capability.
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
* @return {!webdriver.Capabilities} A self reference.
*/
webdriver.Capabilities.prototype.set = function(key, value) {
if (goog.isDefAndNotNull(value)) {
this.caps_[key] = value;
} else {
delete this.caps_[key];
}
return this;
};
/**
* @param {string} key The capability to return.
[bazel]: compile fragments needed by w3c drivers
2018-11-25 15:31:54 +00:00
* @return {*} The capability with the given key, or `null` if it has
Defining a webdriver.Capabilities class for webdriverjs.
2013-06-22 15:37:10 -07:00
* not been set.
*/
webdriver.Capabilities.prototype.get = function(key) {
var val = null;
if (this.caps_.hasOwnProperty(key)) {
val = this.caps_[key];
}
return goog.isDefAndNotNull(val) ? val : null;
};
/**
* @param {string} key The capability to check.
* @return {boolean} Whether the specified capability is set.
*/
webdriver.Capabilities.prototype.has = function(key) {
return !!this.get(key);
};
* Add more options to the Builder API (every common, settable capability should be covered). * Require calling Builder.usingServer(url) to use a remote server. If this is not called, the builder will attempt to create a client locally, throwing an error if it can't (e.g. for IE). * Add browser specific constructors to simplify creating a client without the Builder. Fixes issue 7593
2014-08-20 21:09:18 -07:00
/**
* Sets the logging preferences. Preferences may be specified as a
* {@link webdriver.logging.Preferences} instance, or a as a map of log-type to
* log-level.
* @param {!(webdriver.logging.Preferences|Object.<string, string>)} prefs The
* logging preferences.
* @return {!webdriver.Capabilities} A self reference.
*/
webdriver.Capabilities.prototype.setLoggingPrefs = function(prefs) {
return this.set(webdriver.Capability.LOGGING_PREFS, prefs);
};
/**
* Sets the proxy configuration for this instance.
* @param {webdriver.ProxyConfig} proxy The desired proxy configuration.
* @return {!webdriver.Capabilities} A self reference.
*/
webdriver.Capabilities.prototype.setProxy = function(proxy) {
return this.set(webdriver.Capability.PROXY, proxy);
};
/**
* Sets whether native events should be used.
* @param {boolean} enabled Whether to enable native events.
* @return {!webdriver.Capabilities} A self reference.
*/
webdriver.Capabilities.prototype.setEnableNativeEvents = function(enabled) {
return this.set(webdriver.Capability.NATIVE_EVENTS, enabled);
};
/**
* Sets how elements should be scrolled into view for interaction.
* @param {number} behavior The desired scroll behavior: either 0 to align with
* the top of the viewport or 1 to align with the bottom.
* @return {!webdriver.Capabilities} A self reference.
*/
webdriver.Capabilities.prototype.setScrollBehavior = function(behavior) {
return this.set(webdriver.Capability.ELEMENT_SCROLL_BEHAVIOR, behavior);
};
/**
* Sets the default action to take with an unexpected alert before returning
* an error.
Fix documentation typo.
2014-08-24 18:12:32 -07:00
* @param {string} behavior The desired behavior; should be "accept", "dismiss",
* Add more options to the Builder API (every common, settable capability should be covered). * Require calling Builder.usingServer(url) to use a remote server. If this is not called, the builder will attempt to create a client locally, throwing an error if it can't (e.g. for IE). * Add browser specific constructors to simplify creating a client without the Builder. Fixes issue 7593
2014-08-20 21:09:18 -07:00
* or "ignore". Defaults to "dismiss".
* @return {!webdriver.Capabilities} A self reference.
*/
webdriver.Capabilities.prototype.setAlertBehavior = function(behavior) {
return this.set(webdriver.Capability.UNEXPECTED_ALERT_BEHAVIOR, behavior);
};
Reference in New Issue Copy Permalink