Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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 = newLength

arr.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

Izvori