RangeError

{{JSRef}}

The RangeError object indicates an error when a value is not in the set or range of allowed values.

Description

A RangeError is thrown when trying to pass a value as an argument to a function that does not allow a range that includes the value.

This can be encountered when:

passing a value that is not one of the allowed string values to {{jsxref("String.prototype.normalize()")}} , or
when attempting to create an array of an illegal length with the {{jsxref("Array")}} constructor, or
when passing bad values to the numeric methods {{jsxref("Number.prototype.toExponential()")}} , {{jsxref("Number.prototype.toFixed()")}} or {{jsxref("Number.prototype.toPrecision()")}} .

RangeError is a {{Glossary("serializable object")}} , so it can be cloned with {{DOMxRef("Window.structuredClone", "structuredClone()")}} or copied between Workers using {{domxref("Worker/postMessage()", "postMessage()")}} .

RangeError is a subclass of {{jsxref("Error")}} .

Constructor

{{jsxref("RangeError/RangeError", "RangeError()")}}
- : Creates a new RangeError object.

Instance properties

Also inherits instance properties from its parent {{jsxref("Error")}} .

These properties are defined on RangeError.prototype and shared by all RangeError instances.

{{jsxref("Object/constructor", "RangeError.prototype.constructor")}}
- : The constructor function that created the instance object. For RangeError instances, the initial value is the {{jsxref("RangeError/RangeError", "RangeError")}} constructor.
{{jsxref("Error/name", "RangeError.prototype.name")}}
- : Represents the name for the type of error. For RangeError.prototype.name, the initial value is "RangeError".

Instance methods

Inherits instance methods from its parent {{jsxref("Error")}} .

Examples

Using RangeError (for numeric values)

function check(n) {
  if (!(n >= -500 && n <= 500)) {
    throw new RangeError("The argument must be between -500 and 500.");
  }
}

try {
  check(2000);
} catch (error) {
  if (error instanceof RangeError) {
    // Handle the error
  }
}

Using RangeError (for non-numeric values)

function check(value) {
  if (!["apple", "banana", "carrot"].includes(value)) {
    throw new RangeError(
      'The argument must be an "apple", "banana", or "carrot".',
    );
  }
}

try {
  check("cabbage");
} catch (error) {
  if (error instanceof RangeError) {
    // Handle the error
  }
}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

docs.rodeo

MDN Web Docs mirror