CKTIS / JavaScript
Promise.prototype.finally — opruimen nadat een promise is afgerond
Promise.prototype.finally voert een functie uit nadat een promise is vervuld of afgewezen. Het biedt een gedeelde opruimactie die normaal gesproken de oorspronkelijke uitkomst behoudt, al kan een fout tijdens het opruimen die uitkomst vervangen.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
promise.finally(onFinally)Promise.prototype.finally registreert onFinally, dat asynchroon wordt aangeroepen nadat de promise is vervuld of afgewezen. De functie krijgt geen argumenten: niet de waarde en ook niet de reden voor de afwijzing. Bij standaardpromises retourneert de methode een nieuwe promise zonder de oorspronkelijke te wijzigen.
Een gewone waarde die onFinally retourneert, wordt genegeerd. Als de functie zonder problemen eindigt, behoudt de keten de oorspronkelijke waarde of afwijzingsreden. Retourneert de functie een promise of thenable, dan wacht de keten totdat die is afgehandeld. Een gegooide uitzondering of afwijzing vervangt de oorspronkelijke uitkomst door een nieuwe afwijzing; blijft de verwerking voor altijd in behandeling, dan blokkeert dat de rest van de keten.
Dit is niet hetzelfde als then(onFinally, onFinally): die functies krijgen een argument en hun resultaat kan de vorige waarde vervangen. finally() handelt een fout niet zelf af — gebruik catch() op de geretourneerde keten. Standaardpromiseverwerking negeert een argument dat geen functie is.
De methode maakt sinds ES2018 deel uit van ECMAScript, niet van Web APIs. De taalspecificatie bevestigt niet dat een bepaalde browser de methode ondersteunt; de aanwezigheid van Node 24 in een repository bewijst dat evenmin. In het voorbeeld vervangt "ignored" niet 42, en de tweede opruimactie verwijdert de afwijzing niet.
Voorbeelden
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));Resultaat
cleanup 42 cleanup after rejection failure
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.