Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Promise.withResolvers(): promise se zpřístupněnými funkcemi pro vyřešení

Promise.withResolvers() vrací novou promise a související funkce resolve a reject. Umožňuje oddělit vytvoření promise od předání jejího výsledku, například při přizpůsobování rozhraní založeného na callbackách.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const { promise, resolve, reject } = Promise.withResolvers();

Promise.withResolvers() je statická metoda z ECMAScriptu 2024, nikoli Web API. Nepřijímá žádné argumenty a vrací běžný objekt s vlastnostmi promise, resolve a reject. Promise vytvořená pomocí Promise.withResolvers() zpočátku čeká na výsledek; na rozdíl od new Promise(executor) nepředáváte vykonavací funkci.

resolve(value) přijímá hodnotu nebo převezme budoucí výsledek promise či thenable. Volání resolve proto nemusí znamenat okamžité splnění. reject(reason) promise zamítne. Záleží pouze na prvním volání jedné z těchto funkcí; další volání se ignorují, i když převzatý výsledek ještě není známý.

Handlery zaregistrované pomocí .then() se vykonávají asynchronně. Příklad nejprve vypíše sync a potom fulfilled: 42; volání reject se ignoruje. Funkce pro vyřešení zpřístupňujte pouze kódu, který má výsledek řídit.

Dostupnost ověřte pomocí typeof Promise.withResolvers === "function". Samotná specifikace nepotvrzuje podporu v konkrétním prohlížeči; nepotvrzuje ji ani Node 24 v repozitáři.

Příklady

const { promise, resolve, reject } = Promise.withResolvers();

promise.then(
  value => console.log(`fulfilled: ${value}`),
  reason => console.log(`rejected: ${reason}`)
);

resolve(42);
reject("ignored");
console.log("sync");

Výsledek

sync
fulfilled: 42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje