Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

`length`: zapisywalna właściwość tablicy

Odczyt `arr.length` podaje długość tablicy, a przypisanie do tej właściwości może skrócić tę samą tablicę lub wydłużyć ją bez tworzenia elementów.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

arr.length
arr.length = newLength

arr.length to własna właściwość danych instancji Array, a nie właściwość length konstruktora Array. Początkowo można ją zapisywać, ale nie jest enumerowalna ani konfigurowalna. Jest większa od każdego własnego indeksu tablicowego i może przekraczać liczbę istniejących elementów.

Zmniejszenie length usuwa własne elementy o indeksach równych nowej długości lub od niej większych. Zapis arr.length = 0 opróżnia zwykłą tablicę w miejscu: zmianę widać przez wszystkie odwołania do tego samego obiektu. Zwiększenie długości pozostawia puste miejsca, a nie elementy o wartości undefined, i nie przywraca usuniętych elementów. Utworzenie elementu pod prawidłowym indeksem i równym bieżącej długości lub od niej większym zwiększa ją do i + 1.

Długość jest wartością typu Number i musi być liczbą całkowitą od 0 do 2 ** 32 - 1 włącznie. Przy zapisie do zapisywalnej właściwości wartość jest konwertowana: na przykład "3" zostaje przyjęte jako 3, ale 2.5, -1 i 2 ** 32 powodują RangeError. Konwersja Symbol lub BigInt powoduje TypeError.

Jeśli skracanie napotka niekonfigurowalny element, zatrzymuje się na jego indeksie. Długość przyjmuje wartość tego indeksu plus jeden, a wcześniej usunięte elementy o wyższych indeksach nie wracają. Można też trwale ustawić dla length atrybut writable: false. Blokuje to przypisania do length i dodawanie elementów, które wymagałyby wydłużenia tablicy, ale nie blokuje wszystkich zmian elementów. W obu przypadkach nieudane przypisanie powoduje TypeError w trybie ścisłym; poza nim nie zgłasza błędu.

Przykłady

(() => {
  "use strict";
  const arr = ["a", "b", "c"];
  const alias = arr;

  arr.length = 1;
  console.log(`${alias.length}: ${alias.join(",")}`);

  arr.length = 3;
  arr[2] = undefined;
  console.log(`${arr.length}: ${Object.hasOwn(arr, 1)}, ${Object.hasOwn(arr, 2)}`);

  arr[4] = "e";
  console.log(`${arr.length}: ${arr[4]}`);

  try {
    arr.length = 2.5;
  } catch (error) {
    console.log(`${error.name}: ${arr.length}`);
  }
})();

Wynik

1: a
3: false, true
5: e
RangeError: 5

`alias` widzi skrócenie tej samej tablicy. Po wydłużeniu `Object.hasOwn` odróżnia puste miejsce pod indeksem `1` od jawnie zapisanej wartości `undefined` pod indeksem `2`. Zapis pod indeksem `4` zwiększa długość do `5`, a odrzucona wartość `2.5` jej nie zmienia.

Powiązane lekcje

  • JavaScript · Lekcja 20 · Zaawansowany · Wersja: 4

Źródła