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.