RangeError

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() (en-US), Number.toFixed()Number.toPrecision().

Propiedades

RangeError.prototype (en-US)
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

{{page('/es/docs/Web/JavaScript/Reference/Global_Objects/RangeError/prototype', 'Propiedades')}}

Métodos

{{page('/es/docs/Web/JavaScript/Reference/Global_Objects/RangeError/prototype', 'Métodos')}}

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! (en-US)
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)

Vea también