CKTIS / JavaScript
finally — o bloco final de uma instrução try
A palavra-chave finally introduz um bloco executado depois de try e de qualquer catch, antes de o fluxo de controlo prosseguir. Permite realizar tarefas de limpeza mesmo perante um return ou uma exceção, mas pode substituir o resultado anterior.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
try {
// statements
} finally {
// cleanup
}
try {
// statements
} catch (error) {
// error handling
} finally {
// cleanup
}finally é uma palavra-chave reservada que introduz o bloco final de uma instrução try. As formas válidas são try…finally e try…catch…finally; finally isolado é inválido. As chavetas são obrigatórias e, quando existe finally, catch é opcional.
Quando a execução sai de try e de qualquer catch, o bloco finally é executado primeiro: tanto após uma conclusão normal como perante um return, uma exceção, break ou continue. Utilize-o para tarefas de limpeza que têm de ocorrer antes de o fluxo de controlo prosseguir. Isto não garante a execução após o encerramento do processo nem se o código anterior nunca terminar.
Se finally terminar normalmente, o resultado de controlo anterior é preservado. Um return, throw ou break ou continue permitido naquele contexto que saia de finally substitui esse resultado; pode, por isso, ocultar uma exceção ou alterar um valor devolvido. Evite estas instruções no código de limpeza. Uma exceção lançada por finally não é tratada pelo catch da mesma instrução try.
No exemplo, o valor "done" é avaliado antes da limpeza, mas task() só o devolve depois de acrescentar "cleanup".
Exemplos
function run() {
const events = [];
function task() {
try {
events.push("work");
return "done";
} finally {
events.push("cleanup");
}
}
const result = task();
return events.join(" -> ") + " | " + result;
}
console.log(run());Resultado
work -> cleanup | done
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.