El objeto RangeError
indica un error cuando un valor no se encuentra dentro de un rango de valores permitidos.
Sintaxis
new RangeError([message[, fileName[, lineNumber]]])
Parámetros
message
- Opcional. Mensaje de error
fileName
- Opcional. Nombre del fichero que contiene el código donde se produjo el error
lineNumber
- Opcional. Número de línea de código donde se produjo el error
Descripción
Se lanza un RangeError
cuando se pasa como parámetro a una función un número que no está dentro del rango que dicha función permite. Esto puede ocurrir cuando se intenta crear un array con una longitud inválida con el constructor Array
, o al pasar valores inválidos a los métodos numéricos Number.toExponential()
, Number.toFixed()
o Number.toPrecision()
.
Propiedades
RangeError.prototype
- Permite añadir propiedades a objetos
RangeError
.
Métodos
RangeError
no contiene métodos, pero hereda a través de la cadena de prototipos.
Instancias de RangeError
Propiedades
RangeError.prototype.constructor
- Especifica la función que crea instancias del prototipo.
RangeError.prototype.message
- Mensaje de error. Aunque ECMA-262 especifica que
RangeError
debe procurar su propiomessage
, en SpiderMonkey, se hereda deError.prototype.message
. RangeError.prototype.name
- Nombre del error. Heredada de
Error
. RangeError.prototype.fileName
- Ruta al fichero en el que se produjo el error. Heredada de
Error
. RangeError.prototype.lineNumber
- Número de línea en el fichero en el que se produjo el error. Heredada de
Error
. RangeError.prototype.columnNumber
- Número de columna de la línea en la que se produjo. Heredada de
Error
. RangeError.prototype.stack
- Pila de llamadas. Heredada de
Error
.
Métodos
Aunque el prototipo del objeto RangeError
no contiene métodos propios, las instancias de RangeError
heredan algunos a través de la cadena de prototipos.
Ejemplos
Utilizando RangeError
var check = function(num) {
if (num < MIN || num > MAX) {
throw new RangeError('El parámetro debe estar entre ' + MIN + ' y ' + MAX);
}
};
try {
check(500);
}
catch (e) {
if (e instanceof RangeError) {
// TODO: Manejar el error de rango
}
}
Especificaciones
Especificación | Estado | Comentario |
---|---|---|
ECMAScript 3rd Edition (ECMA-262) | Standard | Definición inical. |
ECMAScript 5.1 (ECMA-262) La definición de 'RangeError' en esta especificación. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La definición de 'RangeError' en esta especificación. |
Standard |
Compatibilidad en navegadores
We're converting our compatibility data into a machine-readable JSON format.
This compatibility table still uses the old format,
because we haven't yet converted the data it contains.
Find out how you can help!
Característica | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Soporte básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Característica | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Soporte básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |