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.