CKTIS / JavaScript
Promise.prototype.finally — nettoyage après la résolution d’une promesse
Promise.prototype.finally exécute une fonction après la réalisation ou le rejet d’une promesse. Il permet un nettoyage commun qui préserve normalement le résultat initial, même si un échec du nettoyage peut le remplacer.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
promise.finally(onFinally)Promise.prototype.finally enregistre onFinally, qui est appelée de manière asynchrone après la réalisation ou le rejet de la promesse. La fonction ne reçoit aucun argument : ni la valeur ni la raison du rejet. Pour les promesses standard, la méthode renvoie une nouvelle promesse sans modifier l’originale.
Une valeur ordinaire renvoyée par onFinally est ignorée. Si la fonction se termine correctement, la chaîne conserve la valeur ou la raison du rejet initiale. Si elle renvoie une promesse ou un thenable, la chaîne attend sa résolution. Une exception levée ou un rejet remplace le résultat initial par un nouveau rejet ; une attente qui ne se termine jamais bloque la suite de la chaîne.
Ce n’est pas équivalent à then(onFinally, onFinally) : ces fonctions reçoivent un argument et leur résultat peut remplacer la valeur précédente. finally() ne gère pas lui-même une erreur — utilisez catch() sur la chaîne renvoyée. Un argument qui n’est pas une fonction est ignoré par le traitement standard des promesses.
Cette méthode fait partie d’ECMAScript depuis ES2018, et non des Web APIs. La spécification du langage ne confirme pas sa prise en charge par un navigateur particulier ; la présence de Node 24 dans un dépôt ne le prouve pas non plus. Dans l’exemple, "ignored" ne remplace pas 42, et le second nettoyage ne supprime pas le rejet.
Exemples
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));Résultat
cleanup 42 cleanup after rejection failure
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.