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()
orNumber.prototype.toPrecision()
.
Constructor
RangeError()
- Creates a new
RangeError
object.
Instance properties
RangeError.prototype.message
- Error message. Although ECMA-262 specifies that
RangeError
should provide its ownmessage
property, in SpiderMonkey, it inheritsError.prototype.message
. RangeError.prototype.name
- Error name. Inherited from
Error
. RangeError.prototype.fileName
- Path to file that raised this error. Inherited from
Error
. RangeError.prototype.lineNumber
- Line number in file that raised this error. Inherited from
Error
. RangeError.prototype.columnNumber
- Column number in line that raised this error. Inherited from
Error
. RangeError.prototype.stack
- Stack trace. Inherited from
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) === false) { 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
Specification |
---|
ECMAScript (ECMA-262) The definition of 'RangeError' in that specification. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
RangeError | Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 5.5 | Opera Full support 5 | Safari Full support 1 | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support 10.1 | Safari iOS Full support 1 | Samsung Internet Android Full support 1.0 | nodejs Full support 0.1.100 |
RangeError() constructor | Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 5.5 | Opera Full support 5 | Safari Full support 1 | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support 10.1 | Safari iOS Full support 1 | Samsung Internet Android Full support 1.0 | nodejs Full support 0.1.100 |
Legend
- Full support
- Full support