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:
- 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()
oNumber.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
Specification |
---|
ECMAScript Language Specification # sec-native-error-types-used-in-this-standard-rangeerror |
Compativilidad con navegadores
BCD tables only load in the browser