Promise.reject()
Promise.reject() is a JavaScript method in the Promise category. Returns a Promise rejected with the given reason. The syntax is Promise.reject(reason). A typical example: Promise.reject(new Error("fail")). The TypeScript signature is (reason?: any): Promise. A close sibling is Promise.prototype.then(), which attaches handlers for the resolved value. A close sibling is Promise.prototype.catch(), which attaches a handler for rejection. A close sibling is Promise.prototype.finally(), which attaches a handler that runs regardless of outcome. A close sibling is Promise.resolve(), which returns a Promise resolved with the given value. More about this category: Promise methods for async operations — then, all, race, and more. Related Promise methods: Promise.prototype.then(), Promise.prototype.catch(), Promise.prototype.finally(), Promise.resolve(), Promise.all(), Promise.allSettled(), Promise.race(), Promise.any(). This page is part of the free JS Reference documentation covering 1027+ methods, each with syntax, parameters, return values, examples, and common pitfalls. You can try Promise.reject() immediately in the JavaScript playground, look up unfamiliar terms in the glossary, or return to the JS Reference homepage.