Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

RangeError — un valor fuera del rango permitido

RangeError es un tipo de error integrado de ECMAScript que indica un valor fuera de un conjunto o rango permitido. Permite señalar argumentos no válidos y gestionar estas excepciones con try...catch.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

new RangeError(message)
RangeError(message)
throw new RangeError(message)

RangeError es un tipo de error integrado de ECMAScript cuyas instancias heredan de Error. Indica un valor fuera de un conjunto o rango permitido; no tiene por qué tratarse de superar un límite numérico. No es una interfaz de una API web.

new RangeError(message) crea un objeto de error con un mensaje opcional. La llamada RangeError(message) sin new también crea un objeto nuevo. Crear el error por sí solo no interrumpe la ejecución: usa throw new RangeError(message) para lanzar una excepción.

Algunas operaciones lanzan este error automáticamente. Por ejemplo, new Array(-1) rechaza una longitud negativa. Con un único argumento de tipo Number, el constructor Array requiere una longitud entera desde 0 hasta 2 ** 32 - 1, ambos incluidos. Leer un elemento más allá del final de un array ordinario no lanza por sí mismo un RangeError.

Gestiona la excepción esperada con try...catch y vuelve a lanzar los errores que no estén relacionados. En el ejemplo, instanceof RangeError comprueba el tipo dentro del mismo realm; los objetos de otro realm, como un frame, pueden no superar esta prueba. No compares los mensajes de error generados por el motor: su texto no es un contrato portable.

Ejemplos

try {
  new Array(-1);
} catch (error) {
  if (!(error instanceof RangeError)) throw error;
  console.log(error.name);
  console.log(error instanceof Error);
}

Resultado

RangeError
true

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes