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.