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 Language Specification # sec-promise.reject

Browser compatibility

Report problems with this compatibility data on GitHub

	desktop						mobile						server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	Deno	Node.js
`reject()`	ChromeFull support32	EdgeFull support12	FirefoxFull support29	Internet ExplorerNo supportNo	OperaFull support19	SafariFull support8	WebView AndroidFull support4.4.3	Chrome AndroidFull support32	Firefox for AndroidFull support29	Opera AndroidFull support19	Safari on iOSFull support8	Samsung InternetFull support2.0	DenoFull support1.0	Node.jsFull support0.12.0

Full support: Full support
No support: No support

Promise.reject()

Legend