---
title: RangeError
slug: Web/JavaScript/Reference/Global_Objects/RangeError
tags:
  - Class
  - JavaScript
  - Object
  - RangeError
translation_of: Web/JavaScript/Reference/Global_Objects/RangeError
---
<div>{{JSRef}}</div>

<p><span class="seoSummary"><code><strong>RangeError</strong></code> オブジェクトは、値が配列内に存在しない、または値が許容範囲にない場合のエラーを表します。</span></p>

<h2 id="Description" name="Description">解説</h2>

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

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

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

<h2 id="Constructor" name="Constructor">コンストラクター</h2>

<dl>
 <dt>{{jsxref("RangeError/RangeError", "RangeError()")}}</dt>
 <dd>新しい <code>RangeError</code> オブジェクトを生成します。</dd>
</dl>

<h2 id="Instance_properties" name="Instance_properties">インスタンスプロパティ</h2>

<dl>
 <dt>{{jsxref("Error.prototype.message", "RangeError.prototype.message")}}</dt>
 <dd>エラーメッセージ。 ECMA-262 は {{jsxref("RangeError")}} 自身が <code>message</code> プロパティを提供するべきであると規定しているにもかかわらず、 <a href="/ja/docs/Mozilla/Projects/SpiderMonkey">SpiderMonkey</a> では {{jsxref("Error.prototype.message")}} が継承される。</dd>
 <dt>{{jsxref("Error.prototype.name", "RangeError.prototype.name")}}</dt>
 <dd>エラー名。 {{jsxref("Error")}} から継承。</dd>
 <dt>{{jsxref("Error.prototype.fileName", "RangeError.prototype.fileName")}}</dt>
 <dd>エラーが発生したファイルへのパス。 {{jsxref("Error")}} から継承。</dd>
 <dt>{{jsxref("Error.prototype.lineNumber", "RangeError.prototype.lineNumber")}}</dt>
 <dd>エラーが発生したファイルの行番号。 {{jsxref("Error")}} から継承。</dd>
 <dt>{{jsxref("Error.prototype.columnNumber", "RangeError.prototype.columnNumber")}}</dt>
 <dd>エラーが発生したファイルの列番号。 {{jsxref("Error")}} から継承。</dd>
 <dt>{{jsxref("Error.prototype.stack", "RangeError.prototype.stack")}}</dt>
 <dd>スタックトレース。{{jsxref("Error")}}から継承。</dd>
</dl>

<h2 id="Examples" name="Examples">例</h2>

<h3 id="Using_RangeError_for_numeric_values" name="Using_RangeError_for_numeric_values">数値に対する RangeError の使用</h3>

<pre class="brush: js notranslate">function check(n)
{
    if( !(n &gt;= -500 &amp;&amp; n &lt;= 500) )
    {
        throw new RangeError("The argument must be between -500 and 500.")
    }
}

try
{
    check(2000)
}
catch(error)
{
    if (error instanceof RangeError)
    {
        // Handle the error
    }
}</pre>

<h3 id="Using_RangeError_for_non-numeric_values" name="Using_RangeError_for_non-numeric_values">RangeError の使用 (数値以外に対して)</h3>

<pre class="brush: js notranslate">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
    }
}
</pre>

<h2 id="Specifications" name="Specifications">仕様書</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様書</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-native-error-types-used-in-this-standard-rangeerror', 'RangeError')}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<div>
<p>{{Compat("javascript.builtins.RangeError")}}</p>
</div>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li>{{jsxref("Error")}}</li>
 <li>{{jsxref("Array")}}</li>
 <li>{{jsxref("Number.toExponential()")}}</li>
 <li>{{jsxref("Number.toFixed()")}}</li>
 <li>{{jsxref("Number.toPrecision()")}}</li>
 <li>{{jsxref("String.prototype.normalize()")}}</li>
</ul>