RangeError

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(), Number.prototype.toFixed() o Number.prototype.toPrecision().

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)

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

Compativilidad con navegadores

Véase también

• Error
• Array
• Number.toExponential()
• Number.toFixed()
• Number.toPrecision()
• String.prototype.normalize()