CKTIS / JavaScript
`length`: zapisivo svojstvo polja
Čitanjem `arr.length` dobivaš duljinu polja. Dodjelom vrijednosti možeš skratiti isto polje ili ga produljiti bez stvaranja novih elemenata.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
arr.length
arr.length = newLengtharr.length vlastito je podatkovno svojstvo instance Array, a ne svojstvo length konstruktora Array. U početku je zapisivo, ali nije nabrojivo ni konfigurabilno. Vrijednost mu je veća od svakog vlastitog indeksa polja i može biti veća od broja prisutnih elemenata.
Smanjenje length briše vlastite elemente čiji je indeks jednak novoj duljini ili veći od nje. arr.length = 0 prazni obično polje bez zamjene: promjena je vidljiva kroz sve reference na isto polje. Povećanje duljine ostavlja prazna mjesta, a ne elemente s vrijednošću undefined, i ne vraća izbrisane elemente. Stvaranje elementa na valjanom indeksu i koji je jednak trenutačnoj duljini ili veći od nje povećava duljinu na i + 1.
Duljina je cijeli broj tipa Number od 0 do 2 ** 32 - 1, uključujući obje granice. Pri pisanju u zapisivo svojstvo length dodijeljena se vrijednost pretvara: primjerice, "3" prihvaća se kao 3, ali 2.5, -1 i 2 ** 32 izazivaju RangeError. Pretvaranje vrijednosti tipa Symbol ili BigInt umjesto toga izaziva TypeError.
Ako skraćivanje naiđe na nekonfigurabilan element, zaustavlja se na njegovu indeksu. Duljina postaje taj indeks plus jedan, a već izbrisani elementi s višim indeksima ne vraćaju se. Postavkom writable: false možeš i trajno onemogućiti pisanje u length. Time se blokiraju dodjele u length i dodavanja koja bi produljila polje, ali ne i sve promjene elemenata. U oba slučaja neuspjela dodjela u strogom načinu rada izaziva TypeError; izvan njega ne izaziva iznimku.
Primjeri
(() => {
"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}`);
}
})();Rezultat
1: a 3: false, true 5: e RangeError: 5
Preko `alias` vidi se da se isto polje skratilo. Nakon produljenja `Object.hasOwn` razlikuje prazno mjesto na indeksu `1` od izričito dodijeljene vrijednosti `undefined` na indeksu `2`. Pisanje na indeksu `4` povećava duljinu na `5`; odbijena vrijednost `2.5` ne mijenja je.
Povezane lekcije
- JavaScript · Lekcija 20 · Napredno · Verzija: 4