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

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.

Fontes