Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Promise.prototype.finally — limpieza tras finalizar una promesa

Promise.prototype.finally ejecuta una función cuando una promesa se cumple o se rechaza. Permite realizar una limpieza común que normalmente conserva el resultado original, aunque un fallo durante la limpieza puede sustituirlo.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

promise.finally(onFinally)

Promise.prototype.finally registra onFinally, que se llama de forma asíncrona cuando la promesa se cumple o se rechaza. La función no recibe argumentos: ni el valor ni el motivo del rechazo. En las promesas estándar, el método devuelve una nueva promesa sin modificar la original.

Se ignora cualquier valor ordinario que devuelva onFinally. Si la función termina correctamente, la cadena conserva el valor original o el motivo del rechazo. Si devuelve una promesa o un thenable, la cadena espera a que se resuelva. Una excepción lanzada o un rechazo sustituye el resultado original por un nuevo rechazo; si queda pendiente para siempre, bloquea la continuación de la cadena.

No equivale a then(onFinally, onFinally): esas funciones reciben un argumento y su resultado puede sustituir el valor anterior. finally() no gestiona por sí mismo un error: usa catch() en la cadena devuelta. El manejo estándar de promesas ignora un argumento que no sea una función.

El método forma parte de ECMAScript desde ES2018, no de Web APIs. La especificación del lenguaje no confirma que sea compatible con un navegador concreto; la presencia de Node 24 en un repositorio tampoco lo demuestra. En el ejemplo, "ignored" no sustituye a 42, y la segunda limpieza no elimina el rechazo.

Ejemplos

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));

Resultado

cleanup
42
cleanup after rejection
failure

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes