Promise.reject()

reason

Der Grund, warum dieses Promise abgelehnt wurde.

Ein Promise, das mit dem angegebenen Grund abgelehnt wird.

Die statische Funktion Promise.reject gibt ein Promise zurück, das abgelehnt wird. Für Debugging-Zwecke und selektives Abfangen von Fehlern ist es nützlich, reason zu einem instanceof Error zu machen.

Promise.reject() ist generisch und unterstützt die Vererbung. Das bedeutet, dass es auf Unterklassen von Promise aufgerufen werden kann, und das Ergebnis wird ein Promise des Unterklassen-Typs sein. Dafür muss der Konstruktor der Unterklasse dieselbe Signatur wie der Promise()-Konstruktor implementieren – also eine einzelne executor-Funktion akzeptieren, die mit den Parametern resolve und reject aufgerufen werden kann. Promise.reject() ist im Wesentlichen eine Kurzform für new Promise((resolve, reject) => reject(reason)).

Im Gegensatz zu Promise.resolve() umschließt Promise.reject() den reason immer in einem neuen Promise-Objekt, auch wenn reason bereits ein Promise ist.

Im Gegensatz zu Promise.resolve verwendet die Methode Promise.reject keine bestehenden Promise-Instanzen erneut. Sie gibt immer eine neue Promise-Instanz zurück, die den reason umschließt.

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

Promise.reject() ist eine generische Methode. Sie kann auf jedem Konstruktor aufgerufen werden, der dieselbe Signatur wie der Promise()-Konstruktor implementiert. Zum Beispiel können wir sie auf einem Konstruktor aufrufen, der console.log als reject übergibt:

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