array.length

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

Синтаксис

arr.length

Опис

The value of the length property is an integer with a positive sign and a value less than 2 to the 32nd power (2³²).

You can set the length property to truncate an array at any time. When you extend an array by changing its length property, the number of actual elements does not increase; for example, if you set length to 3 when it is currently 2, the array still contains only 2 elements. Thus, the length property does not necessarily indicate the number of defined values in the array. See also Relationship between length and numerical properties.

Приклади

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

В наступному прикладі, проходження по масиву 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]

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

The following example shortens the array statesUS to a length of 50 if the current length is greater than 50.

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

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

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

Див. також

• Array