Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Promise.prototype.finally — pulizia dopo la conclusione di una promise

Promise.prototype.finally esegue una funzione dopo che una promise è stata mantenuta o rifiutata. Consente una pulizia comune che normalmente conserva l’esito originale, anche se un errore durante la pulizia può sostituirlo.

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.finally(onFinally)

Promise.prototype.finally registra onFinally, chiamata in modo asincrono dopo che la promise è stata mantenuta o rifiutata. La funzione non riceve argomenti: né il valore né il motivo del rifiuto. Per le promise standard, il metodo restituisce una nuova promise senza modificare quella originale.

Un normale valore restituito da onFinally viene ignorato. Se la funzione termina correttamente, la catena conserva il valore originale o il motivo del rifiuto. Se restituisce una promise o un thenable, la catena ne attende la risoluzione. Un’eccezione generata o un rifiuto sostituisce l’esito originale con un nuovo rifiuto; se resta in sospeso per sempre, blocca la prosecuzione della catena.

Non è equivalente a then(onFinally, onFinally): queste funzioni ricevono un argomento e il loro risultato può sostituire il valore precedente. finally() non gestisce da solo un errore: usa catch() sulla catena restituita. La gestione standard delle promise ignora un argomento che non sia una funzione.

Il metodo fa parte di ECMAScript da ES2018, non delle Web APIs. La specifica del linguaggio non conferma il supporto in uno specifico browser; nemmeno la presenza di Node 24 in un repository lo dimostra. Nell’esempio, "ignored" non sostituisce 42 e la seconda pulizia non rimuove il rifiuto.

Esempi

Promise.resolve(42)
  .finally(() => {
    console.log("cleanup");
    return "ignored";
  })
  .then((value) => {
    console.log(value);
    return Promise.reject("failure");
  })
  .finally(() => {
    console.log("cleanup after rejection");
  })
  .catch((reason) => console.log(reason));

Risultato

cleanup
42
cleanup after rejection
failure

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