Dokumentacja języka JavaScript 1.5:Obiekty:Array:length

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

Spis treści 1 Podsumowanie 2 Opis 3 Przykłady 3.1 Przykład: Iteracja przez wszystkie elementy tablicy 3.2 Przykład: Skracanie tablicy

[edytuj] Podsumowanie

32-bitowa liczba całkowita bez znaku określająca liczbę elementów w tablicy.

Własność obiektu: Array
Zaimplementowane w:	JavaScript 1.1, NES 2.0 JavaScript 1.3: length jest 32-bitową liczbą całkowitą bez znaku, z wartością mniejszą niż 232.
Wersja ECMA:	ECMA-262

[edytuj] Opis

Wartością własności length jest dodatnia liczba całkowita mniejsza niż 2 do potęgi 32 (2³²).

W dowolnej chwili możesz ustalić wartość length w celu zmniejszenia rozmiaru tablicy. Ustawienie wartości length na większą niż rozmiar tablicy nie zwiększy liczby elementów, np. jeżeli ustawisz length na 3, podczas gdy obecną wartością jest liczba 2, tablica nadal będzie zawierać tylko 2 elementy.

[edytuj] Przykłady

[edytuj] Przykład: Iteracja przez wszystkie elementy tablicy

W poniższym przykładzie ilość elementów w tablicy numbers jest określana w instrukcji iteracyjnej na podstawie wartości length, następnie wartość każdego elementu jest podwajana.

var numbers = [1,2,3,4,5];
for (var i = 0; i < numbers.length; i++) {
  numbers[i] *= 2;
}
// zawartość tablicy to teraz [2,4,6,8,10];

[edytuj] Przykład: Skracanie tablicy

Poniższy przykład zmniejsza rozmiar tablicy statesUS do 50, jeżeli przekracza on tę wartość.

if (statesUS.length > 50) {
   statesUS.length=50
}