KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Promise.reject — een afgewezen promise maken

Promise.reject(reason) maakt een nieuwe, afgewezen promise met de opgegeven reden. Afwijzingshandlers worden asynchroon uitgevoerd, ook al is de teruggegeven promise al afgewezen zodra deze wordt teruggegeven.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

Promise.reject(reason)

Promise.reject(reason) is een statische methode van de Promise-constructor. De methode geeft een nieuwe promise in de afgewezen toestand terug, met reason als afwijzingsreden. De reden mag elke waarde zijn; als je het argument weglaat, wordt undefined gebruikt. Gebruik bij fouten bij voorkeur een Error-object.

De methode neemt de toestand van een meegegeven promise of van een object met een then-methode (een thenable) niet over. Dat argument zelf wordt de afwijzingsreden. Anders dan Promise.resolve geeft Promise.reject een meegegeven promise niet ongewijzigd terug.

Een gewone aanroep van Promise.reject(reason) is geen synchrone throw: een omringende try...catch vangt de afwijzing zelf niet op. Gebruik .catch(...) of een try...catch rond await. Promise-handlers worden pas uitgevoerd nadat de huidige synchrone code klaar is. Handel afwijzingen af; hoe de hostomgeving op een niet-afgehandelde afwijzing reageert, verschilt per omgeving.

In het voorbeeld verschijnt sync voordat de afwijzingshandler wordt uitgevoerd, en bevestigt true dat de reden dezelfde identiteit behoudt. Roep de methode aan als Promise.reject(...): de this moet een constructor zijn die compatibel is met de conventies van de Promise-constructor. Een losgemaakte aanroep zonder de juiste ontvanger kan daarom een TypeError veroorzaken.

Voorbeelden

const reason = new Error("Invalid input");
const rejected = Promise.reject(reason);

rejected.catch((error) => {
  console.log(error === reason);
  console.log(error.message);
});

console.log("sync");

Resultaat

sync
true
Invalid input

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen