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.

* 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:

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

Compativilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
RangeError
RangeError() constructor
RangeError is serializable

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Véase también