RangeError: invalid array length

訊息

RangeError: invalid array length (V8-based & Firefox)
RangeError: Array size is not a small enough positive integer. (Safari)

RangeError: Invalid array buffer length (V8-based)
RangeError: length too large (Safari)

錯誤類型

哪裡出錯了？

當試圖使用無效的長度來產生 Array 或 ArrayBuffer 時，可能會出現此錯誤，無效長度包含：

• 透過建構子或設定 length 屬性來指定負數長度。
• 透過建構子或設定 length 屬性來指定非整數長度。（ArrayBuffer 建構子會將長度強制轉換為整數，但 Array 建構子不會。）
• 超過平台支援的最大長度。對於陣列，最大長度為 2³²-1。對於 ArrayBuffer，在 32 位元系統上，最大長度為 2³¹-1（2GiB-1），或在 64 位元系統上為 2³³ï¼ˆ8GiB）。這可能透過建構子、設定 length 屬性，或隱含設定 length 屬性的陣列方法（例如 push 和 concat）發生。

如果你正在使用建構子建立 Array，你可能想改用字面值表示法，因為第一個引數會被解釋為 Array 的長度。否則，你可能會想在設定 length 屬性或將其作為建構子的引數之前，先限制長度的範圍。

範例

無效的案例

new Array(2 ** 40);
new Array(-1);
new ArrayBuffer(2 ** 32); // 32 位元系統
new ArrayBuffer(-1);

const a = [];
a.length -= 1; // 將 length 屬性設為 -1

const b = new Array(2 ** 32 - 1);
b.length += 1; // 將 length 屬性設為 2^32
b.length = 2.5; // 將 length 屬性設為浮點數

const c = new Array(2.5); // 傳入一個浮點數

// 意外地無限增長陣列的並行修改
const arr = [1, 2, 3];
for (const e of arr) {
  arr.push(e * 10);
}

有效的案例

[2 ** 40]; // [ 1099511627776 ]
[-1]; // [ -1 ]
new ArrayBuffer(2 ** 31 - 1);
new ArrayBuffer(2 ** 33); // Firefox 89 之後的 64 位元系統
new ArrayBuffer(0);

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

const b = new Array(2 ** 32 - 1);
b.length = Math.min(0xffffffff, b.length + 1);
// 0xffffffff 是 2^32 - 1 的十六進位表示法
// 也可以寫成 (-1 >>> 0)

b.length = 3;

const c = new Array(3);

// 因為陣列方法在迭代前會儲存長度，所以在迭代期間增長陣列是安全的
const arr = [1, 2, 3];
arr.forEach((e) => arr.push(e * 10));

參見

• Array
• length
• ArrayBuffer