Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Promise.withResolvers(): obietnica z dostępnymi funkcjami rozstrzygającymi

Promise.withResolvers() zwraca nową obietnicę oraz powiązane funkcje resolve i reject. Pozwala oddzielić utworzenie obietnicy od przekazania jej wyniku, na przykład w adapterze interfejsu opartego na wywołaniach zwrotnych.

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

Składnia

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

Promise.withResolvers() to statyczna metoda z ECMAScript 2024, a nie Web API. Nie przyjmuje argumentów i zwraca zwykły obiekt z właściwościami promise, resolve i reject. Dla Promise.withResolvers() obietnica początkowo oczekuje na wynik; nie przekazujesz funkcji wykonawczej jak w new Promise(executor).

resolve(value) przyjmuje wartość albo przejmuje przyszły wynik obietnicy lub obiektu thenable. Dlatego wywołanie resolve nie zawsze oznacza natychmiastowe spełnienie. reject(reason) odrzuca obietnicę. Tylko pierwsze wywołanie jednej z tych funkcji ma znaczenie; późniejsze są ignorowane, nawet gdy przejmowany wynik nadal nie jest znany.

Procedury obsługi z .then() wykonują się asynchronicznie. W przykładzie najpierw pojawia się sync, potem fulfilled: 42; wywołanie reject jest ignorowane. Udostępniaj funkcje rozstrzygające tylko kodowi, który powinien kontrolować wynik.

Dostępność sprawdzaj przez typeof Promise.withResolvers === "function". Sama specyfikacja nie potwierdza obsługi w konkretnej przeglądarce; Node 24 w repozytorium również jej nie dowodzi.

Przykłady

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");

Wynik

sync
fulfilled: 42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła