Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes