RangeError

RangeErrorオブジェクトは値が配列内に存在しない、または値が許容範囲にない場合のエラーを表します。

構文

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

引数

message

オプション。人が読めるエラーの説明

fileName

オプション。例外を引き起こしたコードを含むファイル名

lineNumber

オプション。例外を引き起こしたコードの行番号

説明

RangeErrorは、関数に対して引数として許容されない範囲の数値を渡そうとした場合に投げられます。許容されない文字を含む文字列を String.prototype.normalize()に渡した場合や、 Arrayコンストラクタで不正な長さの配列を作ろうとした場合、又は数値に関するメソッドNumber.toExponential()、 Number.toFixed()、 又は Number.toPrecision()に不適切な値を渡した場合に発生するでしょう。

プロパティ

RangeError.prototype

RangeErrorオブジェクトにプロパティを追加することができます。

メソッド

グローバルな RangeError オブジェクトは、自分自身のメソッドを持っていませんが、プロトタイプチェーンを通していくつかのメソッドを継承しています。

RangeError インスタンス

プロパティ

メソッド

例

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)
    {
        // Handle the error.
    }
}

RangeErrorの使用 (数値以外に対して)

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

仕様

ブラウザ互換性

参照

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