RangeError() コンストラクター
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
RangeError() コンストラクターは RangeError オブジェクトを生成します。
構文
js
new RangeError()
new RangeError(message)
new RangeError(message, options)
new RangeError(message, fileName)
new RangeError(message, fileName, lineNumber)
RangeError()
RangeError(message)
RangeError(message, options)
RangeError(message, fileName)
RangeError(message, fileName, lineNumber)
メモ:
RangeError() は new があってもなくても呼び出せます。どちらも新しい RangeError インスタンスを生成します。
引数
message省略可-
人間が読むためのエラーの説明です。
options省略可-
以下のプロパティを持つオブジェクトです。
cause省略可-
エラーの具体的な原因を示すプロパティです。 エラーを捕捉し、より具体的または有用なエラーメッセージを付けて再度投げる場合、このプロパティを使用して元のエラーを渡すことができます。
fileName省略可-
例外が発生したコードを含むファイルの名前です。
lineNumber省略可-
例外が発生したコードの行番号です。
例
RangeError の使用 (数値)
js
function check(n) {
if (!(n >= -500 && n <= 500)) {
throw new RangeError("引数は -500 以上 500 以下でなければなりません。");
}
}
try {
check(2000);
} catch (error) {
if (error instanceof RangeError) {
// エラーを処理する
}
}
RangeError の使用 (数値以外)
js
function check(value) {
if (["apple", "banana", "carrot"].includes(value) === false) {
throw new RangeError(
'引数は "apple", "banana", "carrot" のいずれかでなければなりません。',
);
}
}
try {
check("cabbage");
} catch (error) {
if (error instanceof RangeError) {
// エラーを処理する
}
}
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-nativeerror-constructors |