CKTIS / JavaScript
Promise.prototype.finally — почистване след приключване на обещание
Promise.prototype.finally изпълнява функция, след като едно обещание бъде изпълнено или отхвърлено. То позволява общо почистване, което обикновено запазва първоначалния резултат, но грешка при почистването може да го замени.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
promise.finally(onFinally)Promise.prototype.finally регистрира onFinally, която се извиква асинхронно, след като обещанието бъде изпълнено или отхвърлено. Функцията не получава аргументи: нито стойността, нито причината за отхвърлянето. При стандартните обещания методът връща ново обещание, без да променя първоначалното.
Обикновена стойност, върната от onFinally, се игнорира. Ако функцията приключи успешно, веригата запазва първоначалната стойност или причината за отхвърлянето. Ако върне обещание или thenable, веригата изчаква то да се разреши. Хвърлено изключение или отхвърляне заменя първоначалния резултат с ново отхвърляне; ако остане в очакване завинаги, блокира продължението на веригата.
Това не е равнозначно на then(onFinally, onFinally): тези функции получават аргумент и резултатът им може да замени предишната стойност. finally() не обработва грешка самостоятелно — използвайте catch() върху върнатата верига. Стандартната обработка на обещания игнорира аргумент, който не е функция.
Методът е част от ECMAScript от ES2018, а не от Web APIs. Езиковата спецификация не потвърждава поддръжка в конкретен браузър; наличието на Node 24 в хранилище също не я доказва. В примера "ignored" не заменя 42, а второто почистване не премахва отхвърлянето.
Примери
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));Резултат
cleanup 42 cleanup after rejection failure
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.