CKTIS / JavaScript
RangeError — um valor fora do intervalo permitido
RangeError é um tipo de erro integrado no ECMAScript que indica um valor fora de um conjunto ou intervalo permitido. Permite assinalar argumentos inválidos e tratar estas exceções com try...catch.
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 RangeError(message)
RangeError(message)
throw new RangeError(message)RangeError é um tipo de erro integrado no ECMAScript cujas instâncias herdam de Error. Indica um valor fora de um conjunto ou intervalo permitido; isso não tem de significar que foi ultrapassado um limite numérico. Não é uma interface de uma Web API.
new RangeError(message) cria um objeto de erro com uma mensagem opcional. A chamada RangeError(message) sem new também cria um novo objeto. A criação do erro, por si só, não interrompe a execução: utiliza throw new RangeError(message) para lançar uma exceção.
Algumas operações lançam este erro automaticamente. Por exemplo, new Array(-1) rejeita um comprimento negativo. Com um único argumento do tipo Number, o construtor Array exige um comprimento inteiro entre 0 e 2 ** 32 - 1, inclusive. A leitura de um elemento para além do fim de um array normal não lança, por si só, um RangeError.
Trata a exceção esperada com try...catch e volta a lançar os erros não relacionados. No exemplo, instanceof RangeError verifica o tipo dentro do mesmo realm; os objetos de outro realm, como uma frame, podem não passar este teste. Não compares as mensagens de erro geradas pelo motor: o respetivo texto não é um contrato portátil.
Exemplos
try {
new Array(-1);
} catch (error) {
if (!(error instanceof RangeError)) throw error;
console.log(error.name);
console.log(error instanceof Error);
}Resultado
RangeError true
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.