Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Dolžina polja: Array.length

Lastnost length določa dolžino polja, ne pa nujno števila obstoječih elementov. Dodelitev vrednosti lahko elemente izbriše ali poveča dolžino, ne da bi zapolnila nova mesta.

Različica: 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 tukaj označuje lastnost length primerka polja, ki jo beremo kot array.length, ne pa lastnosti konstruktorja Array. To je lastnost, ne metoda. Njena vrednost je celo število od 0 do vključno 2 ** 32 - 1.

Dolžina ni število obstoječih elementov: polje lahko vsebuje prazna mesta. Če dodelitev ustvari element na indeksu polja, ki je enak trenutni dolžini ali večji od nje, se length poveča na vrednost tega indeksa plus ena. Če je bila lastnost length nastavljena kot nezapisljiva, taka dodelitev ne doda elementa in ne podaljša polja: v strogem načinu sproži TypeError, sicer pa ne uspe, ne da bi javila napako. delete array[i] odstrani element, če je ta lastna in konfigurabilna lastnost polja, vendar dolžine ne zmanjša. Če lastna lastnost na tem indeksu ni konfigurabilna, ostane na mestu: delete zunaj strogega načina vrne false, v strogem načinu pa sproži TypeError.

Dodelitev manjše dolžine izbriše lastne elemente z indeksi, ki so večji ali enaki novi dolžini. Povečanje dolžine ne ustvari elementov z vrednostjo undefined, temveč pusti prazna mesta. V primeru zapis na indeks 4 nastavi dolžino na 5, poznejše skrajšanje na 2 pa ta element odstrani.

Če se pri dodelitvi v array.length preveri nova dolžina, negativno število, ulomek, ki ni celo število, NaN, Infinity ali 2 ** 32 sproži RangeError. Če lastnost length ni zapisljiva, je dodelitev zavrnjena brez preverjanja nove dolžine: v strogem načinu sproži TypeError, sicer pa ne uspe brez sporočila o napaki. Sprva je lastnost length zapisljiva in nekonfigurabilna, njen atribut enumerable pa ima vrednost false. Nekonfigurabilen element lahko prepreči krajšanje: dolžina se ustavi pri njegovem indeksu plus ena. V strogem načinu ta dodelitev sproži TypeError, elementi z višjimi indeksi pa so bili morda že izbrisani.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri