База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Дължина на масив: Array.length

Свойството length задава дължината на масива, но не непременно броя на съществуващите елементи. Присвояването на стойност може да изтрие елементи или да увеличи дължината, без да запълни новите позиции.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

array.length
array.length = newLength

Array.length тук означава свойството length на екземпляр на масив, което се чете като array.length, а не свойството на конструктора Array. Това е свойство, а не метод. Стойността му е цяло число от 0 до 2 ** 32 - 1 включително.

Дължината не е броят на съществуващите елементи: масивът може да съдържа празни позиции. Ако присвояването създаде елемент на индекс на масива, равен на текущата дължина или по-голям от нея, length се увеличава до стойността на този индекс плюс едно. Ако записът в length е забранен, такова присвояване не добавя елемента и не увеличава дължината на масива: в строг режим то предизвиква TypeError, а извън строг режим не успява, без да сигнализира за грешка. delete array[i] премахва елемента, ако той е собствено конфигурируемо свойство на масива, но не намалява дължината. Ако собственото свойство на този индекс е неконфигурируемо, то остава на мястото си: извън строг режим delete връща false, а в строг режим предизвиква TypeError.

Присвояването на по-малка дължина изтрива собствените елементи с индекси, по-големи или равни на новата дължина. Увеличаването на дължината не създава елементи със стойност undefined, а оставя празни позиции. В примера записът на индекс 4 задава дължина 5, а последващото скъсяване до 2 премахва този елемент.

Ако присвояването на стойност на array.length стигне до проверка на новата дължина, стойност като отрицателно число, дроб, която не е цяло число, NaN, Infinity или 2 ** 32 предизвиква RangeError. Ако записът в length е забранен, присвояването се отхвърля без проверка на новата дължина: в строг режим предизвиква TypeError, а извън строг режим не успява, без да сигнализира за грешка. Първоначално length може да се записва, не е изброимо и не е конфигурируемо. Неконфигурируем елемент може да блокира скъсяването: дължината спира на неговия индекс плюс едно. В строг режим това присвояване предизвиква TypeError, а елементите с по-високи индекси може вече да са изтрити.

Примери

const items = [10, 20];
items[4] = 50;
console.log(items.length);
console.log(Object.hasOwn(items, 2));
items.length = 2;
console.log(JSON.stringify(items));
items.length = 4;
console.log(items.length);
console.log(Object.hasOwn(items, 2));

Резултат

5
false
[10,20]
4
false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници