Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Długość tablicy: Array.length

Właściwość length określa długość tablicy, ale nie zawsze liczbę istniejących elementów. Zapis do niej może usunąć elementy albo zwiększyć długość bez wypełniania nowych pozycji.

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

array.length
array.length = newLength

Array.length oznacza tutaj właściwość length instancji tablicy, odczytywaną jako array.length, a nie właściwość konstruktora Array. Jest to właściwość, nie metoda. Jej wartość jest liczbą całkowitą od 0 do 2 ** 32 - 1.

Długość nie jest licznikiem istniejących elementów: tablica może zawierać puste pozycje. Jeśli przypisanie utworzy element pod indeksem tablicy równym bieżącej długości lub większym od niej, length wzrośnie do wartości tego indeksu plus jeden. Jeśli length ustawiono jako niezapisywalną, takie przypisanie nie doda elementu ani nie zwiększy długości: w trybie ścisłym zgłosi TypeError, a poza nim nie powiedzie się bez zgłoszenia błędu. delete array[i] usuwa element, jeśli jest on konfigurowalną właściwością własną tablicy, ale nie zmniejsza długości. Jeśli właściwość własna pod tym indeksem jest niekonfigurowalna, pozostaje na miejscu: poza trybem ścisłym delete zwraca false, a w trybie ścisłym zgłasza TypeError.

Przypisanie mniejszej długości usuwa własne elementy o indeksach większych lub równych nowej długości. Zwiększenie długości nie tworzy elementów o wartości undefined; pozostawia puste pozycje. W przykładzie zapis pod indeksem 4 ustawia długość na 5, a późniejsze skrócenie do 2 usuwa ten element.

Jeśli przypisanie do array.length dochodzi do sprawdzenia nowej długości, wartość taka jak liczba ujemna, ułamek niebędący liczbą całkowitą, NaN, Infinity lub 2 ** 32 powoduje RangeError. Jeśli length jest niezapisywalna, przypisanie zostaje odrzucone bez sprawdzania nowej długości: w trybie ścisłym zgłasza TypeError, a poza nim nie udaje się bez zgłoszenia błędu. Początkowo length jest zapisywalna, niewyliczalna i niekonfigurowalna. Niekonfigurowalny element może zablokować skracanie: długość zatrzyma się na jego indeksie plus jeden; w trybie ścisłym takie przypisanie zgłosi TypeError, a elementy o wyższych indeksach mogły już zostać usunięte.

Przykłady

const items = [10, 20];
items[4] = 50;
console.log(items.length);
console.log(Object.hasOwn(items, 2));
items.length = 2;
console.log(JSON.stringify(items));
items.length = 4;
console.log(items.length);
console.log(Object.hasOwn(items, 2));

Wynik

5
false
[10,20]
4
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła