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

CKTIS / JavaScript

throw — lançar uma exceção

A instrução throw lança uma exceção e interrompe a execução normal. Uma cláusula catch pode receber o valor lançado; não pode haver uma quebra de linha entre throw e a respetiva expressão.

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

throw expression;

throw é uma palavra-chave reservada que inicia uma instrução, não uma expressão. A instrução throw expression; avalia a expressão e lança o valor resultante como exceção. É possível lançar qualquer valor JavaScript; para erros, é preferível usar um objeto Error com uma mensagem.

Uma exceção interrompe a execução normal e propaga-se através das chamadas síncronas a funções até um catch envolvente. Se não for tratada, fica por capturar. Se uma exceção não for capturada dentro de uma função async, a promessa devolvida pela função é rejeitada. Envolver apenas a chamada num try/catch não permite capturar essa rejeição. Para a capturar no catch, usa await com a promessa dentro do bloco try.

Os blocos finally são executados quando o controlo sai dos blocos protegidos; um return ou outro throw em finally pode substituir a exceção anterior.

A expressão é obrigatória: throw; por si só é inválido. Não pode existir uma quebra de linha entre throw e o início da expressão — a inserção automática de ponto e vírgula não corrige isto. Para lançar novamente uma exceção capturada, usa throw error; dentro de catch (error).

Exemplos

function requirePositive(value) {
  if (typeof value !== "number" || !(value > 0)) {
    throw new Error("Expected a positive number");
  }
  return value;
}

try {
  requirePositive(0);
  console.log("Not reached");
} catch (error) {
  console.log(error.message);
}

Resultado

Expected a positive number

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