RangeError

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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:

Constructor

RangeError()

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

Número de columna en la línea que generó este error. Heredado de Error.

RangeError.prototype.stack

Seguimiento de pila. Heredado de Error.

Ejemplo

Usando RangeError (para valores numéricos)

js
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)

js
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

Véase también