CKTIS / JavaScript
Promise.resolve — normalizzare un valore in una promise
Promise.resolve(value) permette di trattare un valore ordinario, una promise o un thenable come una promise. Può restituire una promise esistente senza modificarla; resolved non significa che il risultato sia già disponibile né che l’operazione avrà successo.
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
Promise.resolve(value)Promise.resolve(value) è un metodo statico che normalizza un valore in una promise. Se l’argomento viene omesso, si usa undefined. Quando il metodo crea una nuova promise, questa passa allo stato fulfilled con l’argomento come valore se l’argomento è un valore primitivo oppure un oggetto per cui la lettura della proprietà then restituisce un valore non invocabile senza sollevare eccezioni. Se la lettura di then solleva un’eccezione, la nuova promise viene rifiutata e l’eccezione è il motivo del rifiuto.
Se p è una promise autentica, Promise.resolve(p) legge la sua proprietà constructor. Se la lettura restituisce Promise, il metodo restituisce esattamente p. Se il getter di constructor solleva un’eccezione, il metodo la propaga in modo sincrono prima di creare una nuova promise, anche se la valutazione dell’argomento p va a buon fine. Il metodo crea una nuova promise se l’argomento non è una promise autentica o se la lettura della sua proprietà constructor restituisce un valore diverso da Promise. Un thenable, cioè un oggetto con un then invocabile, viene assimilato e il risultato ne segue l’esito, anche attraverso ulteriori thenable. Un rifiuto resta un rifiuto; resolved non significa fulfilled.
Le funzioni di callback passate a .then() vengono eseguite in modo asincrono, anche quando la promise è già nello stato fulfilled. Il metodo non intercetta gli errori che si verificano durante la valutazione dell’argomento: se fn() genera un’eccezione in Promise.resolve(fn()), la chiamata la genera in modo sincrono. Per rinviare la chiamata e trasformare tale eccezione in un rifiuto, usa Promise.resolve().then(() => fn()).
Esempi
const p = Promise.resolve(7);
console.log(Promise.resolve(p) === p);
const thenable = { then(resolve) { resolve(42); } };
Promise.resolve(thenable).then(value => console.log(value));
console.log("sync");Risultato
true sync 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.