CKTIS / JavaScript
Promise.reject — stvaranje odbijenog obećanja
Promise.reject(reason) stvara novo odbijeno obećanje s navedenim razlogom. Rukovatelji odbijanja izvršavaju se asinkrono, iako je vraćeno obećanje odbijeno već u trenutku vraćanja.
Verzija: 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) statička je metoda konstruktora Promise. Vraća novo obećanje u stanju odbijanja, s vrijednošću reason kao razlogom odbijanja. Razlog može biti bilo koja vrijednost; ako izostavite argument, upotrebljava se undefined. Za pogreške je najbolje upotrijebiti objekt Error.
Metoda ne preuzima stanje predanog obećanja ni objekta s metodom then (thenable). Sam taj argument postaje razlog odbijanja. Za razliku od Promise.resolve, Promise.reject ne vraća predano obećanje neizmijenjeno.
Običan poziv Promise.reject(reason) nije sinkroni throw: okolni try...catch neće uhvatiti samo odbijanje. Upotrijebite .catch(...) ili try...catch oko await. Rukovatelji obećanja izvršavaju se tek nakon završetka trenutačnog sinkronog koda. Obradite odbijanja; reakcija okruženja na neobrađeno odbijanje ovisi o okruženju domaćina.
U primjeru se sync pojavljuje prije izvršavanja rukovatelja odbijanja, a true potvrđuje da razlog zadržava svoj identitet. Pozovite metodu kao Promise.reject(...): njezin this mora biti konstruktor kompatibilan s konvencijama konstruktora Promise, pa odvojeni poziv bez odgovarajućeg primatelja može izazvati TypeError.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.