reason

Reason why thisPromise rejected.

APromise that is rejected with the given reason.

The staticPromise.reject function returns aPromise that is rejected. For debugging purposes and selective error catching, it is useful to makereason aninstanceofError.

Promise.reject() is generic and supports subclassing, which means it can be called on subclasses ofPromise, and the result will be a promise of the subclass type. To do so, the subclass's constructor must implement the same signature as thePromise() constructor — accepting a singleexecutor function that can be called with theresolve andreject callbacks as parameters.Promise.reject() is essentially a shorthand fornew Promise((resolve, reject) => reject(reason)).

UnlikePromise.resolve(),Promise.reject() always wrapsreason in a newPromise object, even whenreason is already aPromise.

UnlikePromise.resolve, thePromise.reject method does not reuse existingPromise instances. It always returns a newPromise instance that wrapsreason.

const p = Promise.resolve(1);const rejected = Promise.reject(p);console.log(rejected === p); // falserejected.catch((v) => {  console.log(v === p); // true});

Promise.reject() is a generic method. It can be called on any constructor that implements the same signature as thePromise() constructor. For example, we can call it on a constructor that passes itconsole.log asreject:

class NotPromise {  constructor(executor) {    // The "resolve" and "reject" functions behave nothing like the    // native promise's, but Promise.reject() calls them in the same way.    executor(      (value) => console.log("Resolved", value),      (reason) => console.log("Rejected", reason),    );  }}Promise.reject.call(NotPromise, "foo"); // Logs "Rejected foo"

• Promise