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

CKTIS / JavaScript

Promise.race — prva izpolnitev ali zavrnitev

Promise.race(iterable) vrne obljubo, ki prevzame vrednost izpolnitve ali razlog zavrnitve, odvisno od tega, kateri izid se obdela prvi. Ne čaka na prvi uspeh in ne prekliče preostalih operacij.

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.race(iterable)

Promise.race(iterable) je statična metoda, ki sprejme sinhrono iterabilen objekt, na primer polje. Vsak element se obdela prek Promise.resolve: lahko je obljuba, objekt z metodo then ali običajna vrednost.

Rezultat prevzame prvo obdelano izpolnitev ali zavrnitev. Zato lahko zavrnitev prehiti uspeh. Če so vsi elementi običajne vrednosti brez klicljive metode then ali že izpolnjene oziroma zavrnjene nativne obljube, ki jih Promise.resolve vrne nespremenjene, zmagovalca določi vrstni red iteracije. Vendar lahko Promise.resolve že izpolnjeno ali zavrnjeno nativno obljubo iz drugega okolja ECMAScript (realm) ovije v novo obljubo. Prevzem njenega stanja nato zahteva dodatne asinhrone korake. Običajna vrednost ali že izpolnjena oziroma zavrnjena obljuba iz istega okolja lahko zato zmaga, tudi če se med iteracijo pojavi pozneje. Obravnavalniki rezultata se še vedno izvedejo asinhrono.

Promise.race([]) ostane za vedno v stanju čakanja. Napaka pri pridobivanju iteratorja ali med iteracijo povzroči zavrnitev rezultata. Metoda ne prekliče poraženih operacij: za njihovo ustavitev je potreben ločen mehanizem.

V primeru pending za vedno ostane v stanju čakanja. Promise.resolve vrne drugi dve obljubi nespremenjeni. Zavrnjena je pred izpolnjeno, zato je rezultat rejected: failed. Vrstica sync se izpiše prej, ker se obravnavalnik, posredovan metodi then, ne izvede v trenutnem skladu klicev.

Primeri

const pending = new Promise(() => {});
const result = Promise.race([
  pending,
  Promise.reject("failed"),
  Promise.resolve("ready")
]);

result.then(
  value => console.log("fulfilled: " + value),
  reason => console.log("rejected: " + reason)
);
console.log("sync");

Rezultat

sync
rejected: failed

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

Viri