Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Objetos semelhantes a arrays

Um objeto semelhante a um array expõe um comprimento e propriedades indexadas, mas não tem necessariamente de ser um array ou um objeto iterável. Saiba qual é o papel de `length` e como `Array.from()` cria um array a partir desta estrutura.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

const arrayLike = { 0: value0, 1: value1, length: 2 };

Um objeto semelhante a um array (array-like) tem normalmente uma propriedade length e elementos acessíveis através de índices de 0 a length - 1. Não é uma classe distinta nem garante que o objeto seja um array. Um exemplo é arguments dentro de uma função normal; não herda métodos de array como map().

A propriedade length de um objeto semelhante a um array indica o seu comprimento. Os métodos de array normalizam o seu valor para um número inteiro entre 0 e 2 ** 53 - 1. Não é necessário que todos os índices existam. Num objeto normal, adicionar um índice não atualiza automaticamente length, e reduzir length não elimina propriedades — ao contrário do que acontece num array.

Ser semelhante a um array e ser iterável são características distintas. A propriedade length, por si só, não fornece o método [Symbol.iterator]() exigido por for...of e pela sintaxe [...value]. Array.from() utiliza o método iterador se este puder ser invocado. Só lê length e as propriedades indexadas se a propriedade Symbol.iterator não existir ou tiver o valor undefined ou null. Se Symbol.iterator tiver outro valor que não possa ser invocado, como false, Array.from() lança um TypeError antes de ler length. Na leitura por índice, um índice em falta dá origem a um elemento presente no novo array, com o valor undefined.

É possível recorrer a muitos métodos de array, por exemplo, com Array.prototype.map.call(arrayLike, fn), mas nem todos os métodos são genéricos. A conversão com Array.from() utiliza apenas ECMAScript e não requer APIs do DOM. Para apresentar os resultados, o exemplo utiliza console.log, disponibilizado pelo ambiente de execução. O facto de o exemplo funcionar em Node.js não comprova o suporte de APIs do browser.

Exemplos

const arrayLike = { 0: "A", 2: "C", length: 3 };
const values = Array.from(arrayLike);

console.log(Array.isArray(arrayLike));
console.log(typeof arrayLike[Symbol.iterator]);
console.log(values.length);
console.log(values[0], values[1], values[2]);
console.log(1 in values);

Resultado

false
undefined
3
A undefined C
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes