Array.length

Сводка

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

Атрибуты свойстваArray.length
Записываемое да
Перечисляемое нет
Настраиваемое нет

Синтаксис

arr.length

Описание

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

В любой момент вы можете установить свойство 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;
}

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

Спецификация Статус Комментарий
ECMAScript 1-е издание. Стандарт Изначальное определение.
ECMAScript 5.1 (ECMA-262)
Определение 'Array.length' в этой спецификации.
Стандарт  
ECMAScript 6 (ECMA-262)
Определение 'Array.length' в этой спецификации.
Кандидат в рекомендации  

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

Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка (Да) (Да) (Да) (Да) (Да)
Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка (Да) (Да) (Да) (Да) (Да) (Да)

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

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

Метки: 
 Внесли вклад в эту страницу: Mingun
 Обновлялась последний раз: Mingun,