CKTIS / JavaScript
Długość i indeksowanie tablic w JavaScript
Właściwość `length` wyznacza zakres indeksów tablicy, ale nie zlicza elementów. Dowiedz się, jak działa zapis pod indeksem i czym puste miejsce różni się od `undefined`.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
a.length; a[i]; a[i] = value; a.length = n; delete a[i]; Object.hasOwn(a, i); a.at(i);Indeksy tablicy zaczynają się od zera. a.length to własna właściwość tablicy, domyślnie zapisywalna, ale niekonfigurowalna. Jej wartość jest liczbą całkowitą od 0 do 2 ** 32 - 1. Wyznacza górną, wyłączną granicę indeksów własnych elementów, a nie ich liczbę. Z kolei Array.length opisuje liczbę parametrów oczekiwanych przez funkcję konstruktora, nie długość tablicy.
Zapis a[i] odwołuje się do właściwości. a[1] i a["1"] używają tego samego klucza. Indeksami są kanoniczne zapisy dziesiętne liczb całkowitych od 0 do 2 ** 32 - 2. Klucze "01", "-1" i "4294967295" nie są indeksami i nie wpływają na długość. a[-1] odczytuje właściwość "-1"; a.at(-1) odczytuje ostatnią pozycję niepustej tablicy. Gdy wyliczony indeks jest poza zakresem, at() zwraca undefined bez odczytu tej właściwości.
Utworzenie własnego elementu pod indeksem i >= a.length zwiększa długość do i + 1. Pominięte pozycje pozostają puste. Puste miejsce nie jest własną właściwością; jego odczyt zwraca undefined, chyba że wartość pochodzi z prototypu. Object.hasOwn(a, i) odróżnia puste miejsce od własnego elementu o wartości undefined. Udane delete a[i] usuwa element bez zmiany długości.
Zwiększenie length tworzy puste miejsca, a skrócenie usuwa własne elementy od nowej granicy wzwyż. Gdy length jest zapisywalna, przypisanie niecałkowitej lub wykraczającej poza dozwolony zakres wartości typu Number powoduje RangeError. Przypisanie wartości typu BigInt powoduje natomiast TypeError podczas konwersji, jeszcze przed sprawdzeniem zakresu. Niekonfigurowalny element może zatrzymać skracanie: elementy o wyższych indeksach mogły już zostać usunięte, a długość zatrzyma się na jego indeksie plus jeden. W trybie ścisłym takie nieudane przypisanie zgłasza TypeError.
Przykłady
{
const a = ["A"];
a[3] = "D";
a[2] = undefined;
a[-1] = "tag";
console.log(`length: ${a.length}`);
console.log(`1: ${a[1]}, own: ${Object.hasOwn(a, 1)}`);
console.log(`2: ${a[2]}, own: ${Object.hasOwn(a, 2)}`);
console.log(`[-1]: ${a[-1]}, at(-1): ${a.at(-1)}`);
a.length = 1;
a.length = 4;
console.log(`length: ${a.length}, own 3: ${Object.hasOwn(a, 3)}, [-1]: ${a[-1]}`);
}Wynik
length: 4 1: undefined, own: false 2: undefined, own: true [-1]: tag, at(-1): D length: 4, own 3: false, [-1]: tag
Indeksy `1` i `2` dają przy odczycie `undefined`, lecz tylko `2` jest własnym elementem. Ponowne wydłużenie nie przywraca elementu `3`; właściwość `"-1"` pozostaje.
Powiązane lekcje
- JavaScript · Lekcja 41 · Zaawansowany · Wersja: 4