CKTIS / JavaScript
Promise.prototype.then — concatenare operazioni asincrone
Promise.prototype.then registra gestori per l’adempimento o il rifiuto e restituisce una nuova promise. Il risultato del gestore determina come prosegue la catena.
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.then(onFulfilled, onRejected)Promise.prototype.then accetta i gestori facoltativi onFulfilled e onRejected. Il primo riceve il valore di adempimento, il secondo il motivo del rifiuto. La chiamata restituisce una nuova promise. I gestori vengono eseguiti in modo asincrono, dopo la fine del codice sincrono corrente, anche quando la promise originale è già stata risolta.
Restituire un valore ordinario adempie la nuova promise, mentre lanciare un’eccezione la rifiuta. Restituire una promise o un oggetto con un metodo then invocabile fa sì che la nuova promise ne adotti l’esito finale. Se si omette return, il risultato è undefined. Restituisci le operazioni asincrone affinché la catena le attenda.
Gli argomenti non invocabili vengono trattati come gestori mancanti: il valore di adempimento o il motivo del rifiuto prosegue nella catena. onRejected non intercetta un’eccezione lanciata da onFulfilled nella stessa chiamata a then; gestiscila in un collegamento successivo. Un ritorno normale da onRejected può ripristinare l’adempimento.
Questo è un meccanismo ECMAScript, non una Web API. Il metodo richiede una promise effettiva come this; la sola presenza di un metodo then non basta. L’esempio mostra la gestione differita, la trasformazione di un valore e il recupero da un errore.
Esempi
console.log('start');
Promise.resolve(3)
.then(value => value * 2)
.then(value => {
console.log(value);
throw new Error('boom');
})
.then(undefined, error => {
console.log(error.message);
return 9;
})
.then(value => console.log(value));
console.log('end');Risultato
start end 6 boom 9
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.