MORPH
SIGN IN SIGN UP
SeleniumHQ / selenium UNCLAIMED

A browser automation framework and ecosystem.

34168 0 92 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.
SimonStewart: Updates to the atoms. Adding the ability to get the visible text, find child elements and various bug fixes r9382
2010-07-25 21:06:09 +00:00
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
/**
* @fileoverview Utilities for working with errors as defined by WebDriver's
all: update links to Github repo Signed-off-by: Andreas Tolfsen <ato@mozilla.com>
2015-03-17 19:15:20 -04:00
* wire protocol: https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
*/
goog.provide('bot.Error');
goog.provide('bot.ErrorCode');
atoms: reorder enums and correct docs
2015-04-09 13:52:53 +01:00
/**
* Error codes from the Selenium WebDriver protocol:
all: update links to Github repo Signed-off-by: Andreas Tolfsen <ato@mozilla.com>
2015-03-17 19:15:20 -04:00
* https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#response-status-codes
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
*
* @enum {number}
[bazel]: Compile JS rules
2018-11-25 13:21:40 +00:00
* @suppress {lintChecks}
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
*/
bot.ErrorCode = {
SUCCESS: 0, // Included for completeness
NO_SUCH_ELEMENT: 7,
NO_SUCH_FRAME: 8,
UNKNOWN_COMMAND: 9,
UNSUPPORTED_OPERATION: 9, // Alias.
STALE_ELEMENT_REFERENCE: 10,
ELEMENT_NOT_VISIBLE: 11,
INVALID_ELEMENT_STATE: 12,
UNKNOWN_ERROR: 13,
ELEMENT_NOT_SELECTABLE: 15,
SimonStewart: Updating constants for error numbers r13094
2011-07-26 17:09:52 +00:00
JAVASCRIPT_ERROR: 17,
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
XPATH_LOOKUP_ERROR: 19,
DanielWagnerHall: Adding missing error codes r13254
2011-08-05 11:08:14 +00:00
TIMEOUT: 21,
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
NO_SUCH_WINDOW: 23,
INVALID_COOKIE_DOMAIN: 24,
SimonStewart: Adding the ability to accept and dismiss alerts. This code is somewhat fragile, but it puts part of what we need in place. r10487
2010-12-01 19:01:54 +00:00
UNABLE_TO_SET_COOKIE: 25,
Update issue 7641 Adjust bot.ErrorCode values for alerts to be consistent with the spec.
2014-07-31 16:21:12 -07:00
UNEXPECTED_ALERT_OPEN: 26,
NO_SUCH_ALERT: 27,
SimonStewart: Restoring the invalid element selector to the js code r13098
2011-07-26 19:15:24 +00:00
SCRIPT_TIMEOUT: 28,
DanielWagnerHall: Adding missing error code r13252
2011-08-05 11:01:18 +00:00
INVALID_ELEMENT_COORDINATES: 29,
EranMes on behalf of EmmaSoderberg: Correctly number error codes in the atoms. The numbering of the codes was bothched in r17797. This caused the tests for required capabilities to fail since the wrong error code was returned. Emma, thanks for all of your hard work\! r17811
2012-09-14 12:26:12 +00:00
IME_NOT_AVAILABLE: 30,
IME_ENGINE_ACTIVATION_FAILED: 31,
DouniaBerrada: Adding ready to inject JS for Web SQL database. r13677
2011-09-01 00:38:53 +00:00
INVALID_SELECTOR_ERROR: 32,
EranMes on behalf of EmmaSoderberg: Correctly number error codes in the atoms. The numbering of the codes was bothched in r17797. This caused the tests for required capabilities to fail since the wrong error code was returned. Emma, thanks for all of your hard work\! r17811
2012-09-14 12:26:12 +00:00
SESSION_NOT_CREATED: 33,
SimonStewart: Adding missing error codes and correcting old error codes with new values. Fixes issue 2514 r13908
2011-09-22 19:20:25 +00:00
MOVE_TARGET_OUT_OF_BOUNDS: 34,
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
SQL_DATABASE_ERROR: 35,
INVALID_XPATH_SELECTOR: 51,
INVALID_XPATH_SELECTOR_RETURN_TYPE: 52,
Make the FirefoxDriver XPI throw exception for unknown timeout type.
2017-03-17 12:37:34 +00:00
INVALID_ARGUMENT: 61,
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
// The following error codes are derived straight from HTTP return codes.
METHOD_NOT_ALLOWED: 405
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
};
/**
atoms: reorder enums and correct docs
2015-04-09 13:52:53 +01:00
* Represents an error returned from a WebDriver command request.
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
*
* @param {!bot.ErrorCode} code The error's status code.
EranMes, on behalf of AndreasHaas: function bot.dom.getInViewLocation to scroll a specified location into view r13858
2011-09-14 16:58:31 +00:00
* @param {string=} opt_message Optional error message.
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
* @constructor
DanielWagnerHall on behalf of assorted Googlers: Making useragent checks consistent wrt product version vs rendering engine version, some fixes for IE9, probably a few other little bugfixes here and there r15504
2012-01-13 17:10:50 +00:00
* @extends {Error}
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
*/
[js] reformat the atoms code, no logical changes
2020-11-27 15:46:30 +00:00
bot.Error = function (code, opt_message) {
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
/**
* This error's status code.
* @type {!bot.ErrorCode}
*/
this.code = code;
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
/** @type {string} */
this.state =
[js] reformat the atoms code, no logical changes
2020-11-27 15:46:30 +00:00
bot.Error.CODE_TO_STATE_[code] || bot.Error.State.UNKNOWN_ERROR;
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
DanielWagnerHall on behalf of assorted Googlers: Making useragent checks consistent wrt product version vs rendering engine version, some fixes for IE9, probably a few other little bugfixes here and there r15504
2012-01-13 17:10:50 +00:00
/** @override */
this.message = opt_message || '';
[js] reformat the atoms code, no logical changes
2020-11-27 15:46:30 +00:00
var name = this.state.replace(/((?:^|\s+)[a-z])/g, function (str) {
IE <9 does not define String.prototype.trim, so we have to strip whitespace manually.
2013-04-30 12:50:56 -07:00
// IE<9 does not support String#trim(). Also, IE does not include 0xa0
// (the non-breaking-space) in the \s character class, so we have to
// explicitly include it.
return str.toUpperCase().replace(/^[\s\xa0]+/g, '');
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
});
Lint warning clean-up.
2013-06-14 07:31:01 -07:00
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
var l = name.length - 'Error'.length;
if (l < 0 || name.indexOf('Error', l) != l) {
name += 'Error';
}
DanielWagnerHall on behalf of assorted Googlers: Making useragent checks consistent wrt product version vs rendering engine version, some fixes for IE9, probably a few other little bugfixes here and there r15504
2012-01-13 17:10:50 +00:00
/** @override */
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
this.name = name;
DanielWagnerHall on behalf of assorted Googlers: Making useragent checks consistent wrt product version vs rendering engine version, some fixes for IE9, probably a few other little bugfixes here and there r15504
2012-01-13 17:10:50 +00:00
// Generate a stacktrace for our custom error; ensure the error has our
// custom name and message so the stack prints correctly in all browsers.
var template = new Error(this.message);
template.name = this.name;
/** @override */
this.stack = template.stack || '';
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
};
DanielWagnerHall on behalf of assorted Googlers: Making useragent checks consistent wrt product version vs rendering engine version, some fixes for IE9, probably a few other little bugfixes here and there r15504
2012-01-13 17:10:50 +00:00
goog.inherits(bot.Error, Error);
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
Reordering declarations. Partially reverts 18f77aceab40d585fe204f89f461969aba1d3bde
2015-04-14 23:40:37 +03:00
/**
* Status strings enumerated in the W3C WebDriver protocol.
* @enum {string}
* @see https://w3c.github.io/webdriver/webdriver-spec.html#handling-errors
*/
bot.Error.State = {
ELEMENT_NOT_SELECTABLE: 'element not selectable',
ELEMENT_NOT_VISIBLE: 'element not visible',
INVALID_ARGUMENT: 'invalid argument',
INVALID_COOKIE_DOMAIN: 'invalid cookie domain',
INVALID_ELEMENT_COORDINATES: 'invalid element coordinates',
INVALID_ELEMENT_STATE: 'invalid element state',
INVALID_SELECTOR: 'invalid selector',
INVALID_SESSION_ID: 'invalid session id',
JAVASCRIPT_ERROR: 'javascript error',
MOVE_TARGET_OUT_OF_BOUNDS: 'move target out of bounds',
NO_SUCH_ALERT: 'no such alert',
NO_SUCH_ELEMENT: 'no such element',
NO_SUCH_FRAME: 'no such frame',
NO_SUCH_WINDOW: 'no such window',
SCRIPT_TIMEOUT: 'script timeout',
SESSION_NOT_CREATED: 'session not created',
STALE_ELEMENT_REFERENCE: 'stale element reference',
TIMEOUT: 'timeout',
UNABLE_TO_SET_COOKIE: 'unable to set cookie',
UNEXPECTED_ALERT_OPEN: 'unexpected alert open',
UNKNOWN_COMMAND: 'unknown command',
UNKNOWN_ERROR: 'unknown error',
UNKNOWN_METHOD: 'unknown method',
UNSUPPORTED_OPERATION: 'unsupported operation'
};
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
/**
* A map of error codes to state string.
* @private {!Object.<bot.ErrorCode, bot.Error.State>}
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
*/
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
bot.Error.CODE_TO_STATE_ = {};
[js] reformat the atoms code, no logical changes
2020-11-27 15:46:30 +00:00
goog.scope(function () {
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
var map = bot.Error.CODE_TO_STATE_;
var code = bot.ErrorCode;
var state = bot.Error.State;
map[code.ELEMENT_NOT_SELECTABLE] = state.ELEMENT_NOT_SELECTABLE;
map[code.ELEMENT_NOT_VISIBLE] = state.ELEMENT_NOT_VISIBLE;
atoms: align list of error strings with W3C WebDriver protocol
2015-04-09 13:49:33 +01:00
map[code.IME_ENGINE_ACTIVATION_FAILED] = state.UNKNOWN_ERROR;
map[code.IME_NOT_AVAILABLE] = state.UNKNOWN_ERROR;
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
map[code.INVALID_COOKIE_DOMAIN] = state.INVALID_COOKIE_DOMAIN;
map[code.INVALID_ELEMENT_COORDINATES] = state.INVALID_ELEMENT_COORDINATES;
map[code.INVALID_ELEMENT_STATE] = state.INVALID_ELEMENT_STATE;
map[code.INVALID_SELECTOR_ERROR] = state.INVALID_SELECTOR;
map[code.INVALID_XPATH_SELECTOR] = state.INVALID_SELECTOR;
map[code.INVALID_XPATH_SELECTOR_RETURN_TYPE] = state.INVALID_SELECTOR;
map[code.JAVASCRIPT_ERROR] = state.JAVASCRIPT_ERROR;
map[code.METHOD_NOT_ALLOWED] = state.UNSUPPORTED_OPERATION;
map[code.MOVE_TARGET_OUT_OF_BOUNDS] = state.MOVE_TARGET_OUT_OF_BOUNDS;
Update issue 7641 Adjust bot.ErrorCode values for alerts to be consistent with the spec.
2014-07-31 16:21:12 -07:00
map[code.NO_SUCH_ALERT] = state.NO_SUCH_ALERT;
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
map[code.NO_SUCH_ELEMENT] = state.NO_SUCH_ELEMENT;
map[code.NO_SUCH_FRAME] = state.NO_SUCH_FRAME;
map[code.NO_SUCH_WINDOW] = state.NO_SUCH_WINDOW;
map[code.SCRIPT_TIMEOUT] = state.SCRIPT_TIMEOUT;
map[code.SESSION_NOT_CREATED] = state.SESSION_NOT_CREATED;
map[code.STALE_ELEMENT_REFERENCE] = state.STALE_ELEMENT_REFERENCE;
map[code.TIMEOUT] = state.TIMEOUT;
map[code.UNABLE_TO_SET_COOKIE] = state.UNABLE_TO_SET_COOKIE;
[bazel]: Compile JS rules
2018-11-25 13:21:40 +00:00
map[code.UNEXPECTED_ALERT_OPEN] = state.UNEXPECTED_ALERT_OPEN;
First step in updating js to support error status strings from the W3C spec: http://www.w3.org/TR/webdriver/#status-codes
2013-04-28 10:02:43 -07:00
map[code.UNKNOWN_ERROR] = state.UNKNOWN_ERROR;
map[code.UNSUPPORTED_OPERATION] = state.UNKNOWN_COMMAND;
}); // goog.scope
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
/**
* Flag used for duck-typing when this code is embedded in a Firefox extension.
SimonStewart: Fixing lint errors and merging in tests from Googlers to the atoms. Minimal changes in the atoms themselves r13368
2011-08-15 04:24:29 +00:00
* This is required since an Error thrown in one component and then reported
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
* to another will fail instanceof checks in the second component.
* @type {boolean}
*/
bot.Error.prototype.isAutomationError = true;
if (goog.DEBUG) {
[bazel]: Compile JS rules
2018-11-25 13:21:40 +00:00
/**
* @override
* @return {string} The string representation of this error.
*/
[js] reformat the atoms code, no logical changes
2020-11-27 15:46:30 +00:00
bot.Error.prototype.toString = function () {
JasonLeyba: Improved error handling for WebDriverJs * Convert the various browser stack trace formats to V8's format * Whenever an async task fails, append the recent task history to its stack, which should provide context for where the offending command was scheduled. Fixes issue 4648. r17991
2012-10-22 22:58:53 +00:00
return this.name + ': ' + this.message;
SimonStewart: Updating constants for error numbers r13094
2011-07-26 17:09:52 +00:00
};
SimonStewart: Updating the atoms. Adding extra tests for the dom atoms, and adding atoms to deal with visibility, text and injecting scripts into a page. r9344
2010-07-19 11:24:30 +00:00
}
Reference in New Issue Copy Permalink