Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje