在此页

• 描述
• 构造函数
• 实例特性
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

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

描述

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() ，或
• 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()

创建新的 RangeError 对象。

实例特性

RangeError.prototype.message

Error message. Although ECMA-262 specifies that RangeError should provide its own message property, in SpiderMonkey , it inherits Error.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 .

范例

使用 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
    }
}
					

使用 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
    }
}
					

规范

规范
ECMAScript (ECMA-262) The definition of 'RangeError' in that specification.

浏览器兼容性

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. 更新 GitHub 上的兼容性数据

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
RangeError	Chrome 1	Edge 12	Firefox 1	IE 5.5	Opera 5	Safari 1	WebView Android 1	Chrome Android 18	Firefox Android 4	Opera Android 10.1	Safari iOS 1	Samsung Internet Android 1.0	nodejs 0.1.100
RangeError() 构造函数	Chrome 1	Edge 12	Firefox 1	IE 5.5	Opera 5	Safari 1	WebView Android 1	Chrome Android 18	Firefox Android 4	Opera Android 10.1	Safari iOS 1	Samsung Internet Android 1.0	nodejs 0.1.100

图例

完整支持

完整支持

另请参阅

• Error
• Array
• Number.toExponential()
• Number.toFixed()
• Number.toPrecision()
• String.prototype.normalize()

元数据

• 最后修改： May 8, 2020

相关话题

1. 标准内置对象
2. Error
3. 特性
   1. Error.prototype.columnNumber
   2. Error.prototype.fileName
   3. Error.prototype.lineNumber
   4. Error.prototype.message
   5. Error.prototype.name
   6. Error.prototype.stack
4. 方法
   1. Error.prototype.toSource()
   2. Error.prototype.toString()
5. 相关页面：
6. EvalError
7. InternalError
8. RangeError
9. ReferenceError
10. SyntaxError
11. TypeError
12. URIError
13. 继承：
14. Function
15. 特性
    1. Function.arguments
    2. Function.caller
    3. Function.displayName
    4. Function.length
    5. Function.name
16. 方法
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toSource()
    5. Function.prototype.toString()
17. Object
18. 特性
    1. Object.prototype.__proto__
    2. Object.prototype.constructor
19. 方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.valueOf()
    12. Object.setPrototypeOf()