RangeError: ungltige Array-Lnge

Nachricht

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)

Fehlerart

Was ist schief gelaufen?

Der Fehler kann auftreten, wenn versucht wird, ein Array oder ArrayBuffer mit einer ungltigen Lnge zu erstellen, welche folgende umfasst:

• Negative Lnge, ber den Konstruktor oder das Setzen der length Eigenschaft.
• Nicht-ganzzahlige Lnge, ber den Konstruktor oder das Setzen der length Eigenschaft. (Der ArrayBuffer-Konstruktor zwingt die Lnge zu einer Ganzzahl, aber der Array-Konstruktor nicht.)
• berschreitung der auf der Plattform untersttzten maximalen Lnge. Fr Arrays betrgt die maximale Lnge 232-1. Fr ArrayBuffer betrgt die maximale Lnge 231-1 (2GiB-1) auf 32-Bit-Systemen oder 233 (8GiB) auf 64-Bit-Systemen. Dies kann ber den Konstruktor, das Setzen der length-Eigenschaft oder Array-Methoden geschehen, die implizit die Lnge setzen (wie push und concat).

Wenn Sie ein Array mithilfe des Konstruktors erstellen, mchten Sie wahrscheinlich stattdessen die Literalschreibweise verwenden, da das erste Argument als Lnge des Array interpretiert wird. Andernfalls mchten Sie mglicherweise die Lnge begrenzen, bevor Sie die length-Eigenschaft festlegen oder sie als Argument des Konstruktors verwenden.

Beispiele

Ungltige Flle

new Array(2 ** 40);
new Array(-1);
new ArrayBuffer(2 ** 32); // 32-bit system
new ArrayBuffer(-1);

const a = [];
a.length -= 1; // set the length property to -1

const b = new Array(2 ** 32 - 1);
b.length += 1; // set the length property to 2^32
b.length = 2.5; // set the length property to a floating-point number

const c = new Array(2.5); // pass a floating-point number

// Concurrent modification that accidentally grows the array infinitely
const arr = [1, 2, 3];
for (const e of arr) {
  arr.push(e * 10);
}

Gltige Flle

[2 ** 40]; // [ 1099511627776 ]
[-1]; // [ -1 ]
new ArrayBuffer(2 ** 31 - 1);
new ArrayBuffer(2 ** 33); // 64-bit systems after 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 is the hexadecimal notation for 2^32 - 1
// which can also be written as (-1 >>> 0)

b.length = 3;

const c = new Array(3);

// Because array methods save the length before iterating, it is safe to grow
// the array during iteration
const arr = [1, 2, 3];
arr.forEach((e) => arr.push(e * 10));

Siehe auch

• Array
• length
• ArrayBuffer