Promise.reject()
The Promise.reject()
method returns a
Promise
object that is rejected with a given reason.
Syntax
Promise.reject(reason);
Parameters
reason
-
Reason why this
Promise
rejected.
Return value
A Promise
that is rejected with the given reason.
Description
The static Promise.reject
function returns a Promise
that is
rejected. For debugging purposes and selective error catching, it is useful to make
reason
an instanceof
Error
.
Examples
Using the static Promise.reject() method
Promise.reject(new Error('fail')).then(function() {
// not called
}, function(error) {
console.error(error); // Stacktrace
});
Specifications
Specification |
---|
ECMAScript Language Specification # sec-promise.reject |
Browser compatibility
BCD tables only load in the browser