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.
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(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 Latest Draft (ECMA-262) The definition of 'Promise.reject' in that specification. |
Draft |
Browser compatibility
To contribute to this compatibility data, please write a pull request against this repository: https://github.com/mdn/browser-compat-data.
Feature | Chrome | Firefox | Edge | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic Support | 32.0 | 29.0 | (Yes) | (No) | 19 | 7.1 |
Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic Support | 4.4.4 | 32.0 | (Yes) | 29 | (No) | (Yes) | 8.0 |
See also
Document Tags and Contributors
Tags:
Contributors to this page:
fscholz,
nmve,
kdex,
jomaxx,
eduardoboucas,
jpmedley,
madarche,
Jib,
realityking,
SphinxKnight
Last updated by:
fscholz,