Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti