RangeError: invalid array length

JavaScript の例外 "Invalid array length" は、 Array または ArrayBuffer を長さが負の数か 2³² 以上で生成しようとした場合、または Array.length プロパティに負の数か 2³² 以上の値を設定しようとした場合に発生します。

メッセージ

RangeError: Array length must be a finite positive integer (Edge)
RangeError: invalid array length (Firefox)
RangeError: Invalid array length (Chrome)
RangeError: Invalid array buffer length (Chrome)

エラー種別

RangeError

原因

配列の長さが不正になるのは、以下のような場合です。

Array や ArrayBuffer を、負の数や 2³² 以上の長さで生成しようとした。
Array.length プロパティに負の数や 2³² 以上の値を設定しようとした。

なぜ Array と ArrayBuffer の length が制限されるのでしょうか？ Array と ArrayBuffer の length プロパティは、符号なし 32 ビット整数で表されるため、値は 0 から 2³²-1 の範囲の値しか保持できません。

コンストラクターを使用して Array を生成すると、最初の引数が Array の長さとして解釈されるので、代わりにリテラル表記を使った方が良いかもしれません。

そうでない場合は、 length プロパティを設定する前、またはコンストラクターの引数として使用する前に、長さを制限しておくとよいでしょう。

例

不正なケース

new Array(Math.pow(2, 40))
new Array(-1)
new ArrayBuffer(Math.pow(2, 32))
new ArrayBuffer(-1)

let a = [];
a.length = a.length - 1;         // length プロパティに -1 を設定

let b = new Array(Math.pow(2, 32) - 1);
b.length = b.length + 1;         // length プロパティに 2^32 を設定

有効なケース

[ Math.pow(2, 40) ]                     // [ 1099511627776 ]
[ -1 ]                                  // [ -1 ]
new ArrayBuffer(Math.pow(2, 32) - 1)
new ArrayBuffer(0)

let a = [];
a.length = Math.max(0, a.length - 1);

let b = new Array(Math.pow(2, 32) - 1);
b.length = Math.min(0xffffffff, b.length + 1);

// 0xffffffff is the hexadecimal notation for 2^32 - 1
// which can also be written as (-1 >>> 0)