Name
RangeError — thrown when a number is out of its legal range
Availability
JavaScript 1.5; JScript 5.5; ECMAScript v3 Inherits from Error
Constructor
new RangeError( )
new RangeError(message)Arguments
-
message An optional error message that provides details about the exception. If specified, this argument is used as the value for the
messageproperty of the RangeError object.
Returns
A newly constructed RangeError object. If the
message argument is specified, the Error
object will use it as the value of its message
property; otherwise, it will use an implementation-defined default
string as the value of that property. When the RangeError( ) constructor is called as a function, without the
new operator, it behaves just as it does when
called with the new operator.
Properties
-
message An error message that provides details about the exception. This property holds the string passed to the constructor, or an implementation-defined default string. See Error.message for details.
-
name A string that specifies the type of the exception. All RangeError objects inherit the value “RangeError” for this property.
Description
An instance of the RangeError class is thrown when a numeric value is not in its legal range. For example, setting the length of an array is set to a negative number causes a RangeError to be thrown. See Error for details about throwing and catching exceptions.