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

CKTIS / JavaScript

`length`: zapisljiva lastnost polja

Z branjem `arr.length` dobiš dolžino polja. S prireditvijo vrednosti lahko isto polje skrajšaš ali podaljšaš, ne da bi ustvaril nove elemente.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

arr.length
arr.length = newLength

arr.length je lastna podatkovna lastnost primerka Array, ne lastnost length konstruktorja Array. Sprva je zapisljiva, ni pa naštevna niti nastavljiva. Njena vrednost je večja od vsakega lastnega indeksa polja in lahko presega število obstoječih elementov.

Zmanjšanje length izbriše lastne elemente z indeksom, ki je enak novi dolžini ali večji od nje. arr.length = 0 izprazni navadno polje, ne da bi ga zamenjal: sprememba je vidna prek vseh sklicev na isto polje. Povečanje dolžine pusti prazna mesta, ne elementov z vrednostjo undefined, in ne obnovi izbrisanih elementov. Če ustvariš element na veljavnem indeksu i, ki je enak trenutni dolžini ali večji od nje, se dolžina poveča na i + 1.

Dolžina je celo število tipa Number od 0 do vključno 2 ** 32 - 1. Pri pisanju v zapisljivo lastnost length se prirejena vrednost pretvori: "3" se na primer sprejme kot 3, medtem ko 2.5, -1 in 2 ** 32 sprožijo RangeError. Pretvorba vrednosti tipa Symbol ali BigInt namesto tega sproži TypeError.

Če skrajševanje naleti na nenastavljiv element, se ustavi pri njegovem indeksu. Dolžina postane ta indeks plus ena, že izbrisani elementi z višjimi indeksi pa se ne obnovijo. Z writable: false lahko tudi trajno onemogočiš pisanje v length. To prepreči prireditve lastnosti length in dodajanje elementov, ki bi polje podaljšali, ne pa vseh sprememb elementov. V obeh primerih neuspešna prireditev v strogem načinu sproži TypeError; zunaj njega ne sproži izjeme.

Primeri

(() => {
  "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

Prek `alias` je vidno, da se je skrajšalo isto polje. Po podaljšanju `Object.hasOwn` razlikuje prazno mesto pri indeksu `1` od izrecno prirejene vrednosti `undefined` pri indeksu `2`. Zapis pri indeksu `4` poveča dolžino na `5`; zavrnjena vrednost `2.5` je ne spremeni.

Povezane lekcije

  • JavaScript · Lekcija 20 · Napredna · Različica: 4

Viri