CKTIS / JavaScript
Obiekty tablicopodobne (array-like)
Obiekt tablicopodobny udostępnia długość i właściwości indeksowane, ale nie musi być tablicą ani obiektem iterowalnym. Poznaj rolę length oraz sposób tworzenia tablicy za pomocą Array.from().
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const arrayLike = { 0: value0, 1: value1, length: 2 };Obiekt tablicopodobny (array-like) zwykle ma właściwość length i elementy dostępne przez indeksy od 0 do length - 1. Nie jest to osobna klasa ani gwarancja, że obiekt jest tablicą. Przykładem jest arguments wewnątrz zwykłej funkcji; nie dziedziczy on metod tablicowych takich jak map().
Właściwość length obiektu tablicopodobnego określa jego długość. Metody tablicowe normalizują ją do liczby całkowitej z zakresu od 0 do 2 ** 53 - 1. Nie wszystkie indeksy muszą istnieć. W zwykłym obiekcie dodanie indeksu nie aktualizuje automatycznie length, a zmniejszenie length nie usuwa właściwości — inaczej niż w tablicy.
Tablicopodobność i iterowalność to odrębne cechy. Sama właściwość length nie zapewnia metody [Symbol.iterator](), wymaganej przez for...of i składnię [...value]. Array.from() używa metody iteratora, jeśli można ją wywołać. Odczytuje length oraz właściwości indeksowane tylko wtedy, gdy właściwości Symbol.iterator nie ma lub jej wartością jest undefined albo null. Jeśli Symbol.iterator ma inną wartość, której nie można wywołać, na przykład false, Array.from() zgłasza TypeError przed odczytaniem length. Przy odczycie według indeksów brakujący indeks daje w nowej tablicy istniejący element o wartości undefined.
Wiele metod tablicowych można wywołać pośrednio, np. Array.prototype.map.call(arrayLike, fn), lecz nie każda metoda jest uniwersalna. Sama konwersja za pomocą Array.from() korzysta wyłącznie z ECMAScript i nie wymaga interfejsów DOM. Do wyświetlenia wyników przykład używa console.log udostępnianego przez środowisko wykonawcze. Działanie w Node.js nie potwierdza obsługi interfejsów przeglądarkowych.
Przykłady
const arrayLike = { 0: "A", 2: "C", length: 3 };
const values = Array.from(arrayLike);
console.log(Array.isArray(arrayLike));
console.log(typeof arrayLike[Symbol.iterator]);
console.log(values.length);
console.log(values[0], values[1], values[2]);
console.log(1 in values);Wynik
false undefined 3 A undefined C true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.