RangeError

Baseline Widely available *

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

* Some parts of this feature may have varying levels of support.

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

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® 2027 Language Specification
# sec-native-error-types-used-in-this-standard-rangeerror

Compativilidad con navegadores

Enable JavaScript to view this browser compatibility table.

Véase también

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 5 ago 2023 by MDN contributors.

View this page on GitHub • Report a problem with this content

Objetos globales
RangeError
Constructor
1. RangeError()
Herencia
Error
Constructor
1. Constructor Error()
Métodos estáticos
1. captureStackTrace()
2. isError()
Propiedades estáticas
1. stackTraceLimit
Métodos de instancia
1. Error.prototype.toString()
Propiedades de instancia
1. Error: cause
2. columnNumber
3. Error.prototype.fileName
4. Error.prototype.lineNumber
5. Error: message
6. Error.prototype.name
7. stack
Object/Function
Métodos estáticos
1. Function.prototype.apply()
2. Function.prototype.bind()
3. Function.prototype.call()
4. Function.prototype.toString()
5. [Symbol.hasInstance]()
Propiedades estáticas
1. Function.displayName
2. Function.length
3. Function.name
4. prototype
5. Function.prototype.arguments
6. Function.caller
Métodos de instancia
1. Object.prototype.__defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. Object.prototype.isPrototypeOf()
7. Object.prototype.propertyIsEnumerable()
8. Object.prototype.toLocaleString()
9. Object.prototype.toString()
10. Object.prototype.valueOf()
Propiedades de instancia
1. Object.prototype.__proto__
2. Object.prototype.constructor
Páginas relacionadas
AggregateError
EvalError
InternalError
ReferenceError
SyntaxError
TypeError
URIError

RangeError

In this article

Help improve MDN