RangeError

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

描述

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

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

RangeError 是一个可序列化对象，所以可以使用 structuredClone() 对它进行克隆，也可以使用 postMessage() 在 Worker 之间拷贝它。

构造函数

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（对于数值）

js
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（对于其他的值）

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

规范

Specification
ECMAScript Language Specification
# sec-native-error-types-used-in-this-standard-rangeerror

浏览器兼容性

BCD tables only load in the browser

参见