RangeError: invalid array length

Tipo de erro

O que houve de errado?

Um comprimento invlido de array pode aparecer nas seguintes situaes:

• Quando criamos um Array ou um ArrayBuffer que tem um comprimento que ou negativo ou maior ou igual a 232, ou
• quando configuramos a propriedade Array.length a um valor que negativo, ou maior ou igual a 232.

Porque Array e ArrayBuffer tem um comprimento limitado? A propriedade length de um Array ou um ArrayBuffer representado por um inteiro 32-bit unsigned, que pode apenas armazenar valores que esto no intervalo de 0 a 232-1.

Se voc est criando um Array, utilizando o construtor, voc provavelmente quer usar a notao literal, onde o primeiro argumento interpretado como o comprimento do Array.

Ao contrrio, voc poderia querer travar o comprimento antes de ajustar a propriedade do comprimento, ou utiliz-lo com um argumento do construtor.

Exemplos

Casos invlidos

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; // define -1  propriedade length

let b = new Array(Math.pow(2, 32) - 1);
b.length = b.length + 1; // define 2^32  propriedade length

Casos vlidos

[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  a notao hexadecimal de 2^32 - 1
// que tambm pode ser escrito como (-1 >>> 0)

Veja tambm

• Array
• Array.length
• ArrayBuffer