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 = newLengtharr.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