CKTIS / JavaScript
TypeError — um erro de operação inválida
TypeError é um tipo de erro integrado em JavaScript que indica frequentemente uma operação incompatível com o tipo de um valor. Pode capturá-lo ou lançá-lo explicitamente ao validar os argumentos de uma funçã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
new TypeError(message)
TypeError(message)
throw new TypeError(message)TypeError é um construtor integrado para erros que herdam de Error, não uma interface de Web API. Normalmente, indica uma operação que um valor não suporta, como chamar um valor que não é uma função. A especificação também o utiliza quando nenhum outro tipo de erro integrado descreve adequadamente a falha.
Quando a operação é bem-sucedida, tanto new TypeError(message) como a chamada a TypeError(message) sem new devolvem um novo objeto de erro em vez de o lançar. Use throw para lançar explicitamente o objeto obtido. O argumento message é opcional, mas a sua conversão numa cadeia de caracteres pode lançar uma exceção antes de ser devolvido um objeto de erro. Por exemplo, new TypeError(Symbol()) lança um TypeError sem uma instrução throw explícita.
As suas funções podem lançar TypeError quando um argumento não cumpre um requisito de tipo. Para um valor do tipo correto, mas fora do intervalo permitido, RangeError é normalmente mais adequado. No exemplo, catch captura o erro esperado e volta a lançar os restantes erros.
Não baseie a lógica no texto exato das mensagens geradas pelo motor: a formulação não é normalizada. O exemplo fornece uma mensagem própria, pelo que o resultado esperado é estável. Uma verificação instanceof TypeError é adequada no mesmo ambiente de execução, mas pode falhar com erros provenientes de outro ambiente, como um iframe separado.
Exemplos
function shout(value) {
if (typeof value !== "string") {
throw new TypeError("Expected a string");
}
return value.toUpperCase();
}
try {
shout(42);
} catch (error) {
if (!(error instanceof TypeError)) {
throw error;
}
console.log(error.name + ": " + error.message);
}Resultado
TypeError: Expected a string
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.