CKTIS / JavaScript
Array.from: tablica z iterowalnego lub array-like
Array.from tworzy nową tablicę z elementów iterable albo z indeksowanych właściwości obiektu array-like i może od razu je mapować.
Wersja: ECMAScript 2026 draft; example target: Node.js 24.22.2
Składnia
Array.from(items[, mapFn[, thisArg]])Array.from(items, mapFn, thisArg) najpierw używa protokołu iteracji, jeśli items ma metodę iteratora; w przeciwnym razie odczytuje length i indeksy obiektu array-like. Zawsze zwraca nowy wynik. Opcjonalny mapFn(value, index) działa podczas tworzenia, a thisArg ustala jego this.
Dla array-like brakujący indeks jest odczytywany jako undefined, więc wynik jest gęsty, nie dziurawy. Dla napisów iterator działa po punktach kodowych, co lepiej obsługuje pary zastępcze niż rozdzielanie po jednostkach UTF-16. null lub undefined powodują TypeError; niebędący funkcją mapFn powoduje TypeError. Inny prymityw bez iteratora może zostać potraktowany jak array-like długości zero i dać pustą tablicę; błędy dostarczonego iteratora są przekazywane.
Metoda jest generyczna względem konstruktora wywołanego jako this, lecz zwykłe Array.from tworzy Array. Długość array-like jest ograniczana do bezpiecznej długości całkowitej. Przykład pokazuje brakujący indeks i mapowanie bez pośredniej tablicy.
Przykłady
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);Wynik
a|gap1|c true