CKTIS / JavaScript
Array.from: array a partir de iterável ou array-like
Array.from cria um array novo a partir de um iterável ou objeto indexado array-like e pode mapear valores durante a construção.
Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintaxe
Array.from(items[, mapFn[, thisArg]])Array.from(items, mapFn, thisArg) usa o protocolo de iteração quando items fornece iterador; caso contrário lê length e propriedades indexadas. Devolve sempre um resultado novo. mapFn(value, index) atua durante a criação e thisArg fornece o respetivo this.
Um índice ausente é lido como undefined, pelo que o resultado é denso. Em strings, o iterador avança por pontos de código Unicode e lida melhor com pares substitutos. null ou undefined falham; um mapFn fornecido mas não invocável lança TypeError. Outro primitivo sem iterador pode ser tratado como array-like de comprimento zero e produzir um array vazio; os erros do iterador fornecido propagam-se.
A função é genérica quanto ao construtor usado como this, embora a chamada normal crie um Array. O comprimento array-like é limitado ao intervalo inteiro seguro. O exemplo mostra um índice ausente e o mapeamento sem array intermédio.
Exemplos
const source = {0: "a", 2: "c", length: 3};
const result = Array.from(source, (value, index) => value ?? `gap${index}`);
console.log(result.join("|"));
console.log(result !== source);Resultado
a|gap1|c true