大网数据广告活动
Web 标准与前端开发

RangeError

· 52CE 我爱测

**`RangeError`** 对象表示一个特定值不在所允许的范围或者集合中的错误。

RangeError 对象表示一个特定值不在所允许的范围或者集合中的错误。

描述

试图将一个值作为参数传递给一个允许的范围不包含该值的函数会引发 RangeError。

在以下的情况中,可能会遇到这个问题:

  • 将不允许的字符串值传递给 String.prototype.normalize(),或
  • 尝试使用 Array 构造函数创建一个具有不合法的长度的字符串,或
  • 传递错误值到数值计算方法(Number.toExponential()、Number.toFixed() 或 Number.toPrecision())。

RangeError 是一个serializable object,所以可以使用 Window.structuredClone 对它进行克隆,也可以使用 Worker/postMessage() 在 Worker 之间拷贝它。

构造函数

  • RangeError/RangeError
    • : 创建一个新的 RangeError 对象。

实例属性

  • Error.prototype.message
    • : 错误消息。继承自 Error。
  • Error.prototype.name
    • : 错误名称。继承自 Error。
  • Error.prototype.cause
    • : 表示导致当前错误被抛出的原因。继承自 Error。
  • Error.prototype.fileName
    • : 引发此错误的文件的路径。继承自 Error。
  • Error.prototype.lineNumber
    • : 引发此错误的代码所在的文件的行号。继承自 Error。
  • Error.prototype.columnNumber
    • : 引发此错误的代码在文件中所在行的列号。继承自 Error。
  • Error.prototype.stack
    • : 堆栈跟踪。继承自 Error。

示例

使用 RangeError(对于数值)

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) {
    // 处理错误
  }
}

使用 RangeError(对于其他的值)

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) {
    // 处理错误
  }
}

规范

浏览器兼容性

参见

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

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。