Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti