RangeError

Baseline Widely available *

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

* Some parts of this feature may have varying levels of support.

**RangeError**物件在一個給定的值不在允許的集合或範圍內時被作為一個錯誤拋出

語法

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

參數

message

可選。具人類可讀性的錯誤說明

fileName

可選。包含造成錯誤發生的程式碼的檔案名稱

lineNumber

可選。造成錯誤發生的程式碼行號

當試著往一個 function 傳入一個不被其允許的值作為參數時，一個RangeError被拋出。這可在多種情況遭遇到，例如傳入一個不被允許的字串值到 String.prototype.normalize()，或試著透過 Array constructor 用一個不合法的長度來創建一個陣列，或往數值方法像是Number.toExponential()、Number.toFixed()、Number.toPrecision() 傳進糟糕的值。

屬性

RangeError.prototype

允許對一個 RangeError 物件增加其屬性。

方法

普遍的 RangeError 自身沒有包含方法，儘管他的確從原型鍊中繼承了一些。

RangeError 物件實體

屬性

RangeError.prototype.message

Error message. Inherited from Error.

RangeError.prototype.name

Error name. Inherited from Error.

RangeError.prototype.cause

Error cause. 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（數值）

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) === 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.
  }
}

規範

Specification

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

瀏覽器相容性

Enable JavaScript to view this browser compatibility table.

參見

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年7月14日 by MDN contributors.

View this page on GitHub • Report a problem with this content

標準內建物件
RangeError
建構子
1. RangeError()
繼承
Error
建構子
1. Error()
靜態方法
1. captureStackTrace()
2. isError()
靜態屬性
1. stackTraceLimit
實體方法
1. toString()
實體屬性
1. cause
2. Error：columnNumber
3. fileName
4. lineNumber
5. message
6. name
7. stack
Object/Function
靜態方法
1. Function.prototype.apply()
2. Function.prototype.bind()
3. Function.prototype.call
4. toString()
5. [Symbol.hasInstance]()
靜態屬性
1. displayName
2. Function.length
3. name
4. prototype
5. arguments
6. caller
實體方法
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
實體屬性
1. __proto__
2. constructor
相關頁面
AggregateError
EvalError
InternalError
ReferenceError
SyntaxError
TypeError
URIError

RangeError

In this article

Help improve MDN