CKTIS / JavaScript
Promise — risultati delle operazioni e funzioni resolve/reject
Una Promise rappresenta un risultato futuro o la causa di un errore. Scopri come l’executor viene eseguito in modo sincrono, come resolve e reject determinano l’esito e come then e catch lo gestiscono in modo asincrono.
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
new Promise((resolve, reject) => { /* report completion */ });
promise.then(onFulfilled, onRejected);
promise.catch(onRejected);Promise rappresenta il risultato di un’operazione che potrebbe concludersi in seguito. Il suo stato è pending, fulfilled o rejected; gli ultimi due sono definitivi. Creare una promise non sposta di per sé il lavoro su un altro thread.
new Promise(executor) chiama l’executor in modo sincrono e gli fornisce le funzioni resolve e reject. resolve(value) adempie la promise con un valore ordinario oppure adotta l’esito di una promise o di un thenable, cioè un oggetto con un metodo then invocabile. reject(reason) rifiuta la promise; è preferibile usare un Error come motivo. La prima chiamata a una delle due funzioni blocca quelle successive, anche se l’esito adottato è ancora pending. Risolvere, quindi, non significa sempre ottenere un adempimento immediato.
Il valore restituito dall’executor viene ignorato. Un’eccezione sincrona generata al suo interno rifiuta la promise, a meno che resolve o reject non siano già stati chiamati. I gestori registrati con then vengono eseguiti in modo asincrono, al termine dell’esecuzione corrente. then restituisce una nuova promise: il valore restituito ne determina l’esito, mentre un’eccezione generata la rifiuta. catch gestisce i rifiuti.
Nell’esempio, l’executor stampa executor e il codice sincrono stampa sync prima di result: 42. La chiamata a reject dopo resolve(21) non ha effetto. L’esempio richiede un ambiente di esecuzione con Promise e console; non presuppone API Web aggiuntive né una versione specifica del browser.
Esempi
const promise = new Promise((resolve, reject) => {
console.log("executor");
resolve(21);
reject(new Error("ignored"));
});
promise
.then(value => value * 2)
.then(value => console.log(`result: ${value}`))
.catch(error => console.log(error.message));
console.log("sync");Risultato
executor sync result: 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.