Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Promise.withResolvers(): una promise con funzioni di risoluzione accessibili

Promise.withResolvers() restituisce una nuova promise e le relative funzioni resolve e reject. Separa la creazione della promise dalla comunicazione del suo esito, per esempio quando si adatta un’interfaccia basata su callback.

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

Sintassi

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

Promise.withResolvers() è un metodo statico di ECMAScript 2024, non una Web API. Non accetta argomenti e restituisce un normale oggetto con le proprietà promise, resolve e reject. Con Promise.withResolvers(), la promise inizialmente resta in attesa di un esito; non si fornisce una funzione esecutrice come con new Promise(executor).

resolve(value) accetta un valore oppure adotta l’esito futuro di una promise o di un thenable. Chiamare resolve, quindi, non significa sempre che la promise venga soddisfatta immediatamente. reject(reason) rifiuta la promise. Conta solo la prima chiamata a una delle due funzioni; le chiamate successive vengono ignorate, anche se l’esito adottato non è ancora noto.

I gestori registrati con .then() vengono eseguiti in modo asincrono. L’esempio stampa prima sync, poi fulfilled: 42; la chiamata a reject viene ignorata. Esponi le funzioni di risoluzione solo al codice che deve controllare l’esito.

Verifica la disponibilità con typeof Promise.withResolvers === "function". La specifica da sola non dimostra il supporto in uno specifico browser; neppure Node 24 nel repository lo dimostra.

Esempi

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

Risultato

sync
fulfilled: 42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti