Class webdriver.Alert
code »webdriver.promise.Promise.<(T|null)>
└ webdriver.promise.Deferred
└ webdriver.Alert
Represents a modal dialog such as alert
, confirm
, or
prompt
. Provides functions to retrieve the message displayed with
the alert, accept or dismiss the alert, and set the response text (in the
case of prompt
).
Constructor
Parameters |
---|
|
Instance Methods
Defined in webdriver.Alert
code »accept ( ) ⇒ !webdriver.promise.Promise.<void>
Accepts this alert.
!webdriver.promise.Promise.<void>
Returns |
---|
|
code »dismiss ( ) ⇒ !webdriver.promise.Promise.<void>
Dismisses this alert.
!webdriver.promise.Promise.<void>
Returns |
---|
|
code »getText ( ) ⇒ !webdriver.promise.Promise.<string>
Retrieves the message text displayed with this alert. For instance, if the
alert were opened with alert("hello"), then this would return "hello".
!webdriver.promise.Promise.<string>
Returns |
---|
|
code »sendKeys ( text ) ⇒ !webdriver.promise.Promise.<void>
Sets the response text on this alert. This command will return an error if
the underlying alert does not support response text (e.g. window.alert and
window.confirm).
!webdriver.promise.Promise.<void>
Parameters |
---|
|
Returns |
|
Defined in webdriver.promise.Deferred
Defined in webdriver.promise.Promise.<(T|null)>
Registers listeners for when this instance is resolved. This function most
overridden by subtypes.
Parameters |
---|
|
Returns |
|
Registers a listener for when this promise is rejected. This is synonymous
with the catch
clause in a synchronous API:
// Synchronous API:
try {
doSynchronousWork();
} catch (ex) {
console.error(ex);
}
// Asynchronous promise API:
doAsynchronousWork().thenCatch(function(ex) {
console.error(ex);
});
catch
clause in a synchronous API:
// Synchronous API:
try {
doSynchronousWork();
} catch (ex) {
console.error(ex);
}
// Asynchronous promise API:
doAsynchronousWork().thenCatch(function(ex) {
console.error(ex);
});
Parameters |
---|
|
Returns |
|
Registers a listener to invoke when this promise is resolved, regardless
of whether the promise's value was successfully computed. This function
is synonymous with the finally
clause in a synchronous API:
// Synchronous API:
try {
doSynchronousWork();
} finally {
cleanUp();
}
// Asynchronous promise API:
doAsynchronousWork().thenFinally(cleanUp);
Note: similar to the finally
clause, if the registered
callback returns a rejected promise or throws an error, it will silently
replace the rejection error (if any) from this promise:
try {
throw Error('one');
} finally {
throw Error('two'); // Hides Error: one
}
webdriver.promise.rejected(Error('one'))
.thenFinally(function() {
throw Error('two'); // Hides Error: one
});
finally
clause in a synchronous API:
// Synchronous API:
try {
doSynchronousWork();
} finally {
cleanUp();
}
// Asynchronous promise API:
doAsynchronousWork().thenFinally(cleanUp);
try {
throw Error('one');
} finally {
throw Error('two'); // Hides Error: one
}
webdriver.promise.rejected(Error('one'))
.thenFinally(function() {
throw Error('two'); // Hides Error: one
});
Parameters |
---|
|
Returns |
|
Instance Properties
Defined in webdriver.Alert
Defined in webdriver.promise.Deferred
code »webdriver.promise.Deferred.prototype.promise : webdriver.promise.Promise.
Represents the eventual value of a completed operation. Each promise may be
in one of three states: pending, resolved, or rejected. Each promise starts
in the pending state and may make a single transition to either a
fulfilled or failed state.
This class is based on the Promise/A proposal from CommonJS. Additional
functions are provided for API compatibility with Dojo Deferred objects.
webdriver.promise.Promise.