RangeError: invalid array length

メッセージ

RangeError: invalid array length (Firefox)
RangeError: Invalid array length (Chrome)
RangeError: Invalid array buffer length (Chrome)

エラータイプ

RangeError

何が悪かったの?

以下のいずれかです：

負数や 2³² 以上の値の数を Array や ArrayBuffer に設定した。
Array.length プロパティを負数や 2³² 以上の値の数に設定した。

なぜ Array と ArrayBuffer の length が制限されるのでしょうか？配列と ArrayBuffer の length プロパティは、符号なし 32-bit 整数を表し、値は 0 から 2^32-1 の範囲の値しか保持できません。

コンストラクタを使用して配列を生成した場合、最初の引数が配列の length と解釈されるように、リテラル表記を使用したいかもしれません。

さもなければ、length プロパティが設定される前、またはコンストラクタの引数として使用される前に、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)