Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Promise — rezultati operacija i funkcije resolve/reject

Promise predstavlja budući rezultat ili razlog neuspjeha. Saznajte kako se executor izvršava sinkrono, kako resolve i reject određuju ishod te kako then i catch taj ishod obrađuju asinkrono.

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

new Promise((resolve, reject) => { /* report completion */ });
promise.then(onFulfilled, onRejected);
promise.catch(onRejected);

Promise predstavlja rezultat operacije koja bi mogla završiti kasnije. Njegovo je stanje pending, fulfilled ili rejected; posljednja su dva konačna. Samo stvaranje obećanja ne premješta rad u drugu dretvu.

new Promise(executor) poziva executor sinkrono i daje mu funkcije resolve i reject. resolve(value) ispunjava obećanje običnom vrijednošću ili preuzima ishod obećanja ili thenablea, odnosno objekta s pozivljivom metodom then. reject(reason) odbija obećanje; kao razlog je preporučljivo upotrijebiti Error. Prvi poziv jedne od tih funkcija onemogućuje sljedeće pozive, čak i ako preuzeti ishod ostaje u stanju pending. Razrješavanje zato ne znači uvijek trenutačno ispunjenje.

Povratna vrijednost executora zanemaruje se. Sinkrona iznimka bačena unutar njega odbija obećanje, osim ako su resolve ili reject već pozvani. Handleri registrirani pomoću then izvršavaju se asinkrono, nakon završetka trenutačnog izvršavanja. then vraća novo obećanje: vraćena vrijednost određuje njegov ishod, a bačena ga iznimka odbija. catch obrađuje odbijanja.

U primjeru executor ispisuje executor, a sinkroni kod ispisuje sync prije result: 42. Poziv funkcije reject nakon resolve(21) nema učinka. Primjer zahtijeva okruženje za izvođenje s Promise i console; ne pretpostavlja dodatne Web API-je ni određenu verziju preglednika.

Primjeri

const promise = new Promise((resolve, reject) => {
  console.log("executor");
  resolve(21);
  reject(new Error("ignored"));
});

promise
  .then(value => value * 2)
  .then(value => console.log(`result: ${value}`))
  .catch(error => console.log(error.message));

console.log("sync");

Rezultat

executor
sync
result: 42

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori