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 String.prototype.normalize, or
- when attempting to create an array of an illegal length with the Array constructor, or
- when passing bad values to the numeric methods Number.prototype.toExponential, Number.prototype.toFixed or Number.prototype.toPrecision.
RangeError
is a
, so it can be cloned with
or copied between Workers using
.
RangeError
is a subclass of Error.
Constructor
- RangeError()
- : Creates a new
RangeError
object.
- : Creates a new
Instance properties
Also inherits instance properties from its parent Error.
These properties are defined on RangeError.prototype
and shared by all RangeError
instances.
- RangeError.prototype.constructor
- : The constructor function that created the instance object. For
RangeError
instances, the initial value is the RangeError constructor.
- : The constructor function that created the instance object. For
- RangeError.prototype.name
- : Represents the name for the type of error. For
RangeError.prototype.name
, the initial value is"RangeError"
.
- : Represents the name for the type of error. For
Instance methods
Inherits instance methods from its parent 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
}
}