Promise.reject()

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

See also

Document Tags and Contributors

 Contributors to this page: fscholz, jpmedley, madarche, Jib, realityking, SphinxKnight
 Last updated by: fscholz,