MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

array.length

Параметр масиву length встановлює або повертає кількість елементів в масиві. Цей параметр є беззнаковим 32-бітним цілим числом, що завжди є більшим за найбільший індекс у масиві.

var items = ['shoes', 'shirts', 'socks', 'sweaters'];
items.length; 

// повертає 4
Опис

Значенням параметру length є ціле число, яке є більшим від нуля і меншим ніж 2 в степені 32 (232).

Ви можете присвоїти в параметр length щоб відсікти масив в будь-який час. Коли ви розширюєте масив, змінюючи його довжину (параметр length), кількість фактичних елементів не збільшується; наприклад, якщо ви присвоїли в поле length 3, коли його значення було 2, то масив все-таки буде містити лише 2 елементи. Таким чином, поле length не обов'язково вказує на кількість визначених значень в цьому масиві. Дивіться також Відносини між довжиною (length) і числовими полями.

Property attributes of array.length
Writable yes
Enumerable no
Configurable no

Приклади

Циклічне проходження по масиву

В наступному прикладі, проходження по масиву numbers відбувається зважаючи на параметр length. Значення кожного елементу подвоюється.

var numbers = [1, 2, 3, 4, 5];

for (var i = 0; i < numbers.length; i++) {
  numbers[i] *= 2;
}
// numbers тепер [2, 4, 6, 8, 10]

Зменшення кількості елементів масиву

Наступний приклад зменшує масив statesUS до довжини 50 якщо його поточна довжина більша ніж 50.

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

Специфікації

Специфікація Статус Коментар
ECMAScript 1st Edition (ECMA-262) Standard Початкове визначення.
ECMAScript 5.1 (ECMA-262)
The definition of 'Array.length' in that specification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Array.length' in that specification.
Standard  
ECMAScript 2017 Draft (ECMA-262)
The definition of 'Array.length' in that specification.
Draft  

Сумісність із браузерами

Особливість Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базова підтримка (Yes) (Yes) (Yes) (Yes) (Yes)
Особливість Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базова підтримка (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Див. також

Мітки документа й учасники

Мітки: 
 Зробили внесок у цю сторінку: piton13, VFedyk
 Востаннє оновлена: piton13,