.reject()

christian.dinh2481 total contributions
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.
All contributors
- christian.dinh2481 total contributions
- Anonymous contributorAnonymous contributor3077 total contributions
- BrandonDusch580 total contributions
- karel.de.smetoutlook.com6 total contributions
- christian.dinh
- Anonymous contributor
- BrandonDusch
- karel.de.smetoutlook.com
Looking to contribute?
- Learn more about how to get involved.
- Edit this page on GitHub to fix an error or make an improvement.
- Submit feedback to let us know how we can improve Docs.