Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori