RangeError: invalid array length

Thông báo

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)

Loại lỗi

Điều gì đã xảy ra?

Lỗi có thể xuất hiện khi cố gắng tạo Array hoặc ArrayBuffer với độ dài không hợp lệ, bao gồm:

• Độ dài âm, thông qua constructor hoặc đặt thuộc tính length.
• Độ dài không phải số nguyên, thông qua constructor hoặc đặt thuộc tính length. (Constructor ArrayBuffer ép kiểu độ dài thành số nguyên, nhưng constructor Array thì không.)
• Vượt quá độ dài tối đa được hỗ trợ bởi nền tảng. Đối với mảng, độ dài tối đa là 2³²-1. Đối với ArrayBuffer, độ dài tối đa là 2³¹-1 (2GiB-1) trên hệ thống 32-bit, hoặc 2³³ (8GiB) trên hệ thống 64-bit. Điều này có thể xảy ra thông qua constructor, đặt thuộc tính length, hoặc các phương thức mảng ngầm đặt thuộc tính length (chẳng hạn như push và concat).

Nếu bạn đang tạo Array bằng constructor, bạn có thể muốn sử dụng ký hiệu ký tự thay thế, vì đối số đầu tiên được hiểu là độ dài của Array. Nếu không, bạn có thể muốn kẹp giá trị độ dài trước khi đặt thuộc tính length, hoặc sử dụng nó làm đối số của constructor.

Ví dụ

Trường hợp không hợp lệ

new Array(2 ** 40);
new Array(-1);
new ArrayBuffer(2 ** 32); // hệ thống 32-bit
new ArrayBuffer(-1);

const a = [];
a.length -= 1; // đặt thuộc tính length thành -1

const b = new Array(2 ** 32 - 1);
b.length += 1; // đặt thuộc tính length thành 2^32
b.length = 2.5; // đặt thuộc tính length thành số thực

const c = new Array(2.5); // truyền số thực

// Sửa đổi đồng thời vô tình làm mảng tăng trưởng vô hạn
const arr = [1, 2, 3];
for (const e of arr) {
  arr.push(e * 10);
}

Trường hợp hợp lệ

[2 ** 40]; // [ 1099511627776 ]
[-1]; // [ -1 ]
new ArrayBuffer(2 ** 31 - 1);
new ArrayBuffer(2 ** 33); // hệ thống 64-bit sau Firefox 89
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 là ký hiệu thập lục phân cho 2^32 - 1
// cũng có thể được viết là (-1 >>> 0)

b.length = 3;

const c = new Array(3);

// Vì các phương thức mảng lưu length trước khi lặp, nên an toàn khi
// tăng trưởng mảng trong quá trình lặp
const arr = [1, 2, 3];
arr.forEach((e) => arr.push(e * 10));

Xem thêm

• Array
• length
• ArrayBuffer