.reject()

Published Jul 27, 2021Updated Aug 17, 2023
Contribute to Docs

Returns a rejected Promise object with a given reason.

Syntax

Promise.reject(reason);

The reason can be most data types, including:

  • numbers
  • strings
  • objects ( ones of type Error recommended for improved error-catching)

Example

A new Promise, myPromise, is rejected with an Error message by default. Lastly, the error message, err.message, is logged to the console through the catch-block.

const myPromise = Promise.reject(new Error('Promise rejected'));
myPromise.catch((err) => {
console.log(err.message); // Output: Promise rejected
});

Codebyte Example

The example below demonstrates rejecting a promise with a string value as the given reason.

us
Visit us
code
Hide code
Code
Output
Hide output
Hide output
Loading...

All contributors

Looking to contribute?

Learn JavaScript on Codecademy