Array.length

Сводка

Свойство length представляется беззнаковым 32-х битным целым числом, указывающим количество элементов в массиве.

Синтаксис

arr.length

Описание

Свойство length является целым числом с положительным знаком и значением, меньшим 2 в степени 32 (2³²).

В любой момент вы можете установить свойство length для обрезки массива. Когда вы расширяете массив, изменяя его свойство length, реальное количество элементов в массиве не увеличивается; например, если вы установите свойство length в 3, когда оно равно 2, массив по-прежнему будет содержить только два элемента. Таким образом, свойство length ничего не говорит о количестве определённых значений в массиве. Также смотрите раздел Взаимосвязь свойства length с числовыми свойствами.

Примеры

Пример: итерирование по массиву

В следующем примере массив 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;
}

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

Совместимость с браузерами

Смотрите также

• Array