Web/JavaScript/Reference/Global objects/Promise/reject

The Promise.reject() method returns a Promise object that is rejected with a 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() {
  // not called
}, function(error) {
  console.error(error); // Stacktrace
});

Specifications

Specification
ECMAScript (ECMA-262)The definition of 'Promise.reject' in that specification.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
`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