RangeError
Baseline 廣泛可用 *
RangeError 物件表示當一個值不在允許值的集合或範圍內時發生的錯誤。
描述
當嘗試將一個值作為引數傳遞給一個不允許包含該值的範圍的函式時，會丟擲 RangeError。
這可能發生在
- 將一個不允許的字串值傳遞給
String.prototype.normalize()，或者 - 在使用
Array建構函式嘗試建立一個非法長度的陣列時，或者 - 將無效值傳遞給數字方法
Number.prototype.toExponential()、Number.prototype.toFixed()或Number.prototype.toPrecision()時。
RangeError 是一個 可序列化的物件，因此可以使用 structuredClone() 進行克隆，或者使用 postMessage() 在 Workers 之間進行復制。
RangeError 是 Error 的子類。
建構函式
RangeError()-
建立一個新的
RangeError物件。
例項屬性
還繼承了其父級 Error 的例項屬性。.
這些屬性定義在 RangeError.prototype 上，並由所有 RangeError 例項共享。
RangeError.prototype.constructor-
建立例項物件的建構函式。對於
RangeError例項，初始值為RangeError建構函式。 RangeError.prototype.name-
表示錯誤型別的名稱。對於
RangeError.prototype.name，初始值為"RangeError"。
例項方法
繼承了其父級 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) {
// Handle the error
}
}
使用 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) {
// Handle the error
}
}
規範
| 規範 |
|---|
| ECMAScript® 2026 語言規範 # sec-native-error-types-used-in-this-standard-rangeerror |
瀏覽器相容性
載入中…