The Promise.reject(reason)
method returns a Promise
object that is rejected with the given reason.
Syntax
Promise.reject(reason);
Parameters
- reason
- Reason why this
Promise
rejected.
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("Testing static reject").then(function(reason) { // not called }, function(reason) { console.log(reason); // "Testing static reject" }); Promise.reject(new Error("fail")).then(function(error) { // not called }, function(error) { console.log(error); // Stacktrace });
Specifications
Specification | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Promise.reject' in that specification. |
Standard | Initial definition in an ECMA standard. |
ECMAScript 2017 Draft (ECMA-262) The definition of 'Promise.reject' in that specification. |
Draft |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 32.0 | 29.0 (29.0) | No support | 19 | 7.1 |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|
Basic support | No support | 32.0 | 29.0 (29.0) | No support | No support | 8 | 32.0 |