CKTIS / JavaScript
Array.from: pole z iterovatelného nebo array-like vstupu
Array.from vytvoří nové pole z iterovatelného nebo indexovaného array-like objektu a může hodnoty rovnou mapovat.
Verze: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntaxe
Array.from(items[, mapFn[, thisArg]])Array.from(items, mapFn, thisArg) použije protokol iterace, pokud items poskytuje iterátor; jinak čte length a indexované vlastnosti. Vždy vrátí nový výsledek. mapFn(value, index) běží během tvorby a thisArg určuje jeho this.
Chybějící index se čte jako undefined, takže výsledek je hustý. U řetězce iterátor postupuje po kódových bodech Unicode a lépe zvládá náhradní páry. null či undefined selže; zadaný nevolatelný mapFn vyvolá TypeError. Jiný primitiv bez iterátoru lze zpracovat jako array-like délky nula a získat prázdné pole; chyby poskytnutého iterátoru se šíří.
Metoda je obecná vůči konstruktoru použitému jako this, běžné volání však tvoří Array. Délka array-like se omezí na bezpečný celočíselný rozsah. Příklad ukazuje chybějící index a mapování bez mezilehlého pole.
Příklady
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);Výsledek
a|gap1|c true