Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Promise.reject — ustvarjanje zavrnjene obljube

Promise.reject(reason) ustvari novo zavrnjeno obljubo z navedenim razlogom. Obdelovalniki zavrnitve se izvedejo asinhrono, čeprav je vrnjena obljuba zavrnjena že ob vrnitvi.

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

Sintaksa

Promise.reject(reason)

Promise.reject(reason) je statična metoda konstruktorja Promise. Vrne novo obljubo v zavrnjenem stanju, pri čemer je reason razlog zavrnitve. Razlog je lahko poljubna vrednost; če argument izpustite, se uporabi undefined. Pri napakah uporabite objekt Error.

Metoda ne prevzame stanja podane obljube ali objekta z metodo then (thenable). Ta argument sam postane razlog zavrnitve. V nasprotju z Promise.resolve Promise.reject podane obljube ne vrne nespremenjene.

Običajen klic Promise.reject(reason) ni sinhroni throw: okoliški try...catch same zavrnitve ne bo ujel. Uporabite .catch(...) ali try...catch okoli await. Obdelovalniki obljub se izvedejo šele, ko se konča trenutna sinhrona koda. Zavrnitve obravnavajte; odziv gostiteljskega okolja na neobravnavano zavrnitev je odvisen od okolja.

V primeru se sync izpiše pred izvajanjem obdelovalnika zavrnitve, true pa potrjuje, da razlog ohrani svojo identiteto. Metodo pokličite kot Promise.reject(...): njen this mora biti konstruktor, združljiv s konvencijami konstruktorja Promise, zato lahko ločen klic brez ustreznega prejemnika sproži TypeError.

Primeri

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");

Rezultat

sync
true
Invalid input

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri