The Promise.reject()
method returns a Promise
object that is rejected with a given reason.
Promise.reject()
Try it
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
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | Deno | Node.js | |
reject |
32
|
12
|
29
|
No
|
19
|
8
|
4.4.3
|
32
|
29
|
19
|
8
|
2.0
|
1.0
|
0.12.0
|
See also
© 2005–2022 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/reject