Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
RangeError: invalid array length
Mensagem
RangeError: invalid array length (Firefox)RangeError: Invalid array length (Chrome)RangeError: Invalid array buffer length (Chrome)
Tipo de erro
RangeErrorO que houve de errado?
Um comprimento inválido de array pode aparecer nas seguintes situações:
- Quando criamos um
Arrayou umArrayBufferque tem um comprimento que ou é negativo ou é maior ou igual a 232, ou - quando configuramos a propriedade
Array.lengtha um valor que é negativo, ou maior ou igual a 232.
PorqueArray eArrayBuffer tem um comprimento limitado? A propriedadelength de umArray ou umArrayBuffer é 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 umArray, utilizando o construtor, você provavelmente quer usar a notação literal, onde o primeiro argumento é interpretado como o comprimento doArray.
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
js
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 lengthlet b = new Array(Math.pow(2, 32) - 1);b.length = b.length + 1; // define 2^32 à propriedade lengthCasos válidos
js
[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)