RangeError: invalid array length

Mensagem

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

Tipo de erro

RangeError

O que houve de errado?

Um comprimento invĂĄlido de array pode aparecer nas seguintes situaçÔes:

  • 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 estĂŁo no intervalo de 0 a 232-1.

Se vocĂȘ estĂĄ criando um Array, utilizando o construtor, vocĂȘ provavelmente quer usar a notação literal, onde o primeiro argumento Ă© interpretado como o comprimento do Array.

Ao contrĂĄrio, vocĂȘ poderia querer travar o comprimento antes de ajustar a propriedade do comprimento, ou utilizĂĄ-lo com um argumento do construtor.

Exemplos

Casos invĂĄlidos

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 vĂĄlidos

[ 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 notação hexadecimal de 2^32 - 1
// que também pode ser escrito como (-1 >>> 0)

Veja também