База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.from: масив от итерируем или array-like вход

Array.from създава нов масив от итерируем или индексиран array-like обект и може да преобразува стойностите при създаването.

Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2

Синтаксис

Array.from(items[, mapFn[, thisArg]])

Array.from(items, mapFn, thisArg) използва протокола за итерация, ако items има итератор; иначе чете length и индексираните свойства. Винаги връща нов резултат. mapFn(value, index) се изпълнява при създаването, а thisArg задава нейното this.

Липсващ индекс се чете като undefined, затова резултатът е плътен. При низ итераторът върви по кодови точки Unicode и обработва по-добре сурогатни двойки. null или undefined се проваля; подаден неизвикваем mapFn хвърля TypeError. Друг примитив без итератор може да се обработи като array-like с нулева дължина и да даде празен масив; грешките от подаден итератор се разпространяват.

Методът е общ спрямо конструктора, използван като this, но обичайното извикване създава Array. Дължината array-like се ограничава до безопасно цяло число. Примерът показва липсващ индекс и директно преобразуване.

Примери

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);

Резултат

a|gap1|c
true

Източници