在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

RangeError() constructor creates an error when a value is not in the set or range of allowed values.

句法

new RangeError([message[, fileName[, lineNumber]]])
					

参数

message 可选

Human-readable description of the error.

fileName 可选

The name of the file containing the code that caused the exception

lineNumber 可选

The line number of the code that caused the exception

范例

使用 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 'NativeError constructors' 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

图例

完整支持

完整支持

另请参阅

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

元数据

• 最后修改： 2020 年 3 月 9 日

相关话题

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()