RangeError

El objeto RangeError indica un error cuando un valor no se encuentra dentro de un rango de valores permitidos.

Descripción

Se lanza un RangeError cuando se intenta pasar un valor como argumento a una función que no permite un rango que incluye el valor.

Esto puede ocurrir cuando:

pasas un valor que no es uno de los valores de cadena permitidos a String.prototype.normalize(), o
cuando intentas crear una matriz de una longitud inválida con el constructor Array, o
cuando pasas valores inválidos a los métodos numéricos Number.prototype.toExponential() (en-US), Number.prototype.toFixed() o Number.prototype.toPrecision().

Constructor

RangeError() (en-US): Crea un nuevo objecto RangeError.

Propiedades de instancia

RangeError.prototype.message: Mensaje de error.
RangeError.prototype.name: Nombre del error. Heredado de Error.
RangeError.prototype.fileName: Ruta al archivo que generó este error. Heredado de Error.
RangeError.prototype.lineNumber: Número de línea en el archivo que generó este error. Heredado de Error.
RangeError.prototype.columnNumber (en-US): Número de columna en la línea que generó este error. Heredado de Error.
RangeError.prototype.stack (en-US): Seguimiento de pila. Heredado de Error.

Ejemplo

Usando RangeError (para valores numéricos)

function check(n) {
  if (!(n >= -500 && n <= 500)) {
    throw new RangeError("El argumento debe estar entre -500 y 500.");
  }
}

try {
  check(2000);
} catch (error) {
  if (error instanceof RangeError) {
    // Manejar el error
  }
}

Usando RangeError (para valores no numéricos)

function check(value) {
  if (["apple", "banana", "carrot"].includes(value) === false) {
    throw new RangeError(
      'El argumento debe de ser una "apple", "banana", o "carrot".',
    );
  }
}

try {
  check("cabbage");
} catch (error) {
  if (error instanceof RangeError) {
    // Manejar el error
  }
}

Especificaciones

Specification
ECMAScript Language Specification # sec-native-error-types-used-in-this-standard-rangeerror

Compativilidad con navegadores

BCD tables only load in the browser