The Promise.reject()
method returns a Promise
object that is rejected with a given reason.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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 (ECMA-262) The definition of 'Promise.reject' in that specification. |
Browser compatibility
To contribute to this compatibility data, please write a pull request against this repository: https://github.com/mdn/browser-compat-data.
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
reject() | Chrome Full support 32 | Edge Full support 12 | Firefox Full support 29 | IE No support No | Opera Full support 19 | Safari Full support 8 | WebView Android Full support 4.4.3 | Chrome Android Full support 32 | Firefox Android Full support 29 | Opera Android Full support 19 | Safari iOS Full support 8 | Samsung Internet Android Full support 2.0 | nodejs Full support 0.12 |
Legend
- Full support
- Full support
- No support
- No support