CKTIS / JavaScript
`length`: свойството на масива, което позволява запис
Прочети `arr.length`, за да получиш дължината на масива, или му присвои стойност, за да скъсиш същия масив или да го удължиш, без да създаваш елементи.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
arr.length
arr.length = newLengtharr.length е собствено свойство за данни на екземпляр на Array, а не свойството length на конструктора Array. Първоначално позволява запис, но не е изброимо и не може да се конфигурира. Стойността му е по-голяма от всеки собствен индекс на масива и може да надвишава броя на наличните елементи.
Намаляването на length изтрива собствените елементи с индекс, равен на новата дължина или по-голям от нея. arr.length = 0 изпразва обикновен масив, без да го заменя: промяната се вижда през всички референции към същия масив. Увеличаването на дължината оставя празни позиции, а не елементи със стойност undefined, и не възстановява изтритите елементи. Създаването на елемент на валиден индекс i, равен на текущата дължина или по-голям от нея, увеличава дължината до i + 1.
Дължината е цяло число от тип Number от 0 до 2 ** 32 - 1 включително. При запис в length, когато свойството позволява запис, присвоената стойност се преобразува: например "3" се приема като 3, но 2.5, -1 и 2 ** 32 предизвикват RangeError. Преобразуването на Symbol или BigInt вместо това предизвиква TypeError.
Ако при скъсяването се стигне до елемент, който не може да се конфигурира, операцията спира на неговия индекс. Дължината става равна на този индекс плюс едно, а вече изтритите елементи с по-високи индекси не се възстановяват. С writable: false можеш също да забраниш записа в length необратимо. Това блокира присвояването на length и добавянето на елементи, които биха удължили масива, но не и всички промени на елементите. И в двата случая неуспешното присвояване предизвиква TypeError в строг режим; извън него не се хвърля изключение.
Примери
(() => {
"use strict";
const arr = ["a", "b", "c"];
const alias = arr;
arr.length = 1;
console.log(`${alias.length}: ${alias.join(",")}`);
arr.length = 3;
arr[2] = undefined;
console.log(`${arr.length}: ${Object.hasOwn(arr, 1)}, ${Object.hasOwn(arr, 2)}`);
arr[4] = "e";
console.log(`${arr.length}: ${arr[4]}`);
try {
arr.length = 2.5;
} catch (error) {
console.log(`${error.name}: ${arr.length}`);
}
})();Резултат
1: a 3: false, true 5: e RangeError: 5
Чрез `alias` се вижда, че същият масив се скъсява. След удължаването `Object.hasOwn` различава празната позиция на индекс `1` от изрично присвоената стойност `undefined` на индекс `2`. Записът на индекс `4` увеличава дължината до `5`, а отхвърлената стойност `2.5` не я променя.
Свързани уроци
- JavaScript · Урок 20 · Напреднало · Версия: 4