Array.prototype.length

array.length

Liczba o jeden większa od najwyższego indeksu tablicy – w zwykłej tablicy liczba elementów. Właściwość można też zapisywać.

Wartość zwracana

Liczbę całkowitą od 0 do 232 − 1.

Przykłady

const list = ['a', 'b', 'c', 'd'];
console.log(list.length);
list.length = 2;
console.log(list);
list.length = 0;
console.log(list);

Wynik:

4
[ 'a', 'b' ]
[]

W tablicy rzadkiej liczą się też puste miejsca:

const sparse = [];
sparse[5] = 'x';
console.log(sparse.length, sparse);

Wynik:

6 [ <5 empty items>, 'x' ]

Na co uważać

  • Zmniejszenie length usuwa elementy na stałe. array.length = 0 opróżnia tablicę bezpośrednio (zmienia się wszędzie, gdzie jest do niej referencja).
  • Długość ciągu znaków to text.length – liczy jednostki 16-bitowe, a nie znaki (emoji ma długość 2).

Obsługa w przeglądarkach

Baseline – szeroko dostępne: działa we wszystkich popularnych przeglądarkach, i to od dawna (najpóźniej od 2015 roku). Od wersji: Chrome 1, Firefox 1, Safari 1; Node.js 0.10.0. Stan: październik 2026 (MDN browser-compat-data).

Zobacz też:
Array.prototype.at()
Array.prototype.fill()
Array.prototype.entries()