RangeError

Baseline 広く利用可能 *

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

* この機能の一部は、対応レベルが異なる場合があります。

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

解説

RangeErrorは、関数に対して引数として許容されない範囲の数値を渡そうとした場合に発生します。

これは次のような場合に発生します。

許容されない文字を含む文字列を String.prototype.normalize() に渡した場合
Array コンストラクターで不正な長さの配列を作ろうとした場合
数値に関するメソッド Number.prototype.toExponential(), Number.prototype.toFixed(), Number.prototype.toPrecision() に不適切な値を渡した場合

コンストラクター

RangeError()

新しい RangeError オブジェクトを生成します。

インスタンスプロパティ

RangeError.prototype.message

エラーメッセージ。 ECMA-262 は RangeError 自身が message プロパティを提供するべきであると規定しているにもかかわらず、 SpiderMonkey では Error.prototype.message が継承される。

RangeError.prototype.name

エラー名。 Error から継承。

RangeError.prototype.fileName

エラーが発生したファイルへのパス。 Error から継承。

RangeError.prototype.lineNumber

エラーが発生したファイルの行番号。 Error から継承。

RangeError.prototype.columnNumber

エラーが発生したファイルの列番号。 Error から継承。

RangeError.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) {
    // 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
  }
}