Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Duljina polja: Array.length

Svojstvo length određuje duljinu polja, ali ne nužno i broj postojećih elemenata. Dodjela vrijednosti može izbrisati elemente ili povećati duljinu bez popunjavanja novih pozicija.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

array.length
array.length = newLength

Array.length ovdje označava svojstvo length instance polja, koje se čita kao array.length, a ne svojstvo konstruktora Array. To je svojstvo, a ne metoda. Njegova je vrijednost cijeli broj od 0 do uključivo 2 ** 32 - 1.

Duljina nije broj postojećih elemenata: polje može sadržavati prazne pozicije. Ako dodjela stvori element na indeksu polja koji je jednak trenutačnoj duljini ili je veći od nje, length se povećava na vrijednost tog indeksa plus jedan. Ako je svojstvo length postavljeno tako da se u njega ne može pisati, takva dodjela ne dodaje element niti povećava duljinu polja: u strogom načinu rada izaziva TypeError, a izvan njega ne uspijeva bez prijave pogreške. delete array[i] uklanja element ako je on vlastito i konfigurabilno svojstvo polja, ali ne smanjuje duljinu. Ako vlastito svojstvo na tom indeksu nije konfigurabilno, ostaje na mjestu: izvan strogog načina rada delete vraća false, a u strogom načinu rada izaziva TypeError.

Dodjela manje duljine briše vlastite elemente čiji su indeksi veći od ili jednaki novoj duljini. Povećanje duljine ne stvara elemente s vrijednošću undefined; ostavlja prazne pozicije. U primjeru zapis na indeks 4 postavlja duljinu na 5, a kasnije skraćivanje na 2 uklanja taj element.

Ako se pri dodjeli vrijednosti svojstvu array.length provjerava nova duljina, negativan broj, razlomak koji nije cijeli broj, NaN, Infinity ili 2 ** 32 uzrokuje RangeError. Ako se u svojstvo length ne može pisati, dodjela se odbija bez provjere nove duljine: u strogom načinu rada izaziva TypeError, a izvan njega ne uspijeva bez prijave pogreške. U početku je length zapisiv, neenumerabilan i nekonfigurabilan. Nekonfigurabilan element može spriječiti skraćivanje: duljina se zaustavlja na njegovu indeksu plus jedan. U strogom načinu rada ta dodjela uzrokuje TypeError, a elementi s višim indeksima možda su već izbrisani.

Primjeri

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));

Rezultat

5
false
[10,20]
4
false

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori