CKTIS / JavaScript
Długość i indeksowanie tablic w JavaScript
Właściwość `length` wyznacza zakres pozycji tablicy JavaScript, ale nie zlicza jej elementów. Zapis pod indeksem może wydłużyć tablicę, a skrócenie usuwa elementy.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
a.length
a[i]
a[i] = value
a.length = newLength
delete a[i]
Object.hasOwn(a, i)
a.at(-1)a.length to własna właściwość danych instancji Array, a nie metoda ani właściwość statyczna. Indeksowanie zaczyna się od 0. W niepustym zakresie a.length - 1 to ostatnia pozycja, ale może nie zawierać elementu. Długość mieści się w przedziale od 0 do 2 ** 32 - 1; największy indeks to 2 ** 32 - 2.
a[1] i a["1"] odwołują się do tego samego klucza. a["01"], a[-1] i a[2 ** 32 - 1] używają kluczy, które nie są indeksami tablicy, więc zapis pod nimi nie zmienia długości. Dla porównania a.at(-1) próbuje odczytać ostatnią pozycję względem długości i zwraca undefined, jeśli tablica ma długość zero.
Gdy zapis utworzy własny element pod indeksem i >= a.length, długość rośnie do i + 1, a pominięte pozycje pozostają puste. Pusta pozycja nie jest własnym elementem o wartości undefined: odczyt może znaleźć odziedziczoną właściwość, a jeśli nie ma żadnej pasującej właściwości, zwraca undefined. Object.hasOwn(a, i) sprawdza obecność własnej właściwości; i in a uwzględnia też prototypy.
Zwiększenie length nie tworzy elementów. Zmniejszenie usuwa własne elementy o indeksach nie mniejszych niż nowa długość, od najwyższego indeksu w dół. Ponowne wydłużenie ich nie przywraca. Udane delete a[i] nie zmniejsza długości.
Przypisanie do zapisywalnej właściwości length liczby spoza dozwolonego zakresu lub liczby niecałkowitej powoduje RangeError. Niekonfigurowalny element może zatrzymać skracanie: długość wyniesie wtedy o jeden więcej niż jego indeks, a wcześniejsze usunięcia nie zostaną cofnięte. W trybie ścisłym nieudane przypisanie w tej sytuacji powoduje TypeError; poza nim nie musi zgłosić błędu.
Przykłady
{
const a = ["A", undefined];
a[3] = "D";
console.log(`${a.length} ${a[1]} ${a[2]}`);
console.log(`${Object.hasOwn(a, 1)} ${Object.hasOwn(a, 2)}`);
a[-1] = "label";
console.log(`${a[-1]} ${a.at(-1)} ${a.length}`);
a.length = 2;
a.length = 4;
console.log(`${a.length} ${Object.hasOwn(a, 3)} ${a[-1]}`);
}Wynik
4 undefined undefined true false label D 4 4 false label
Odczyty indeksów `1` i `2` dają `undefined`, ale tylko `1` jest własnym elementem. Klucz `-1` przechowuje `label`, podczas gdy `a.at(-1)` daje `D`. Skrócenie usuwa `D`; ponowne wydłużenie go nie przywraca i nie narusza właściwości `-1`.
Powiązane lekcje
- JavaScript · Lekcja 28 · Zaawansowany · Wersja: 4