Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła