Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Storage.length i Storage.key(): brojanje stavki i čitanje naziva ključeva

`length` daje broj pohranjenih stavki, a `key(index)` vraća naziv ključa prema njegovu položaju. Redoslijed ključeva nije zajamčen.

Verzija: Current web platform; runtime support varies

Sintaksa

// Web Storage is defined by the HTML Living Standard, not ECMAScript 2024.
storage.length                 // number (read-only)
storage.key(index)             // string | null; zero-based index
storage.getItem(name)          // string | null; lookup by key name

Storage.length/key označava dva člana instance Storage. Svojstvo storage.length samo je za čitanje i daje trenutačan broj parova ključ–vrijednost, a ne veličinu u bajtovima ili kvotu. Metoda storage.key(index) vraća naziv ključa kao niz znakova, a ne njegovu vrijednost. Položaji počinju od nule: proslijedi nenegativan cijeli broj u rasponu tipa unsigned long (od 0 do 2 ** 32 - 1). Ako je pretvoreni indeks veći od trenutačnog length ili mu je jednak, metoda vraća null.

Za čitanje vrijednosti proslijedi naziv metodi storage.getItem(name). I ta metoda može vratiti null, ali tada to znači da ključ ne postoji. Rezultat metode key() provjeri izrazom name !== null, jer i prazan niz znakova može biti valjan naziv ključa.

Redoslijed ključeva ovisi o implementaciji i može se promijeniti nakon izmjene sadržaja. Ne pretpostavljaj redoslijed umetanja i ne spremaj indeks kao identifikator ključa. Ako je redoslijed prikaza važan, prikupi nazive i izričito ih sortiraj. Spremanje vrijednosti length ne stvara snimku stanja: promjene tijekom prolaska mogu uzrokovati preskakanje ključeva ili njihov dvostruki obilazak.

Web Storage definiran je HTML standardom i nije dio ECMAScripta 2024. window.localStorage vezan je uz podrijetlo (origin) i može se očuvati nakon ponovnog pokretanja preglednika. window.sessionStorage dodatno je odvojen po karticama ili prozorima najviše razine: podaci se zadržavaju pri ponovnom učitavanju, ali su vezani uz sesiju stranice. Ne pretpostavljaj dostupnost u svakom izvršnom okruženju. Dohvat bilo kojeg objekta pohrane može izazvati SecurityError zbog neprozirnog podrijetla ili pravila preglednika. Pri upisu može nastati QuotaExceededError, primjerice kada je kvota iscrpljena.

Primjeri

(() => {
  function demonstrate(storage) {
    if (storage.length !== 0) {
      throw new Error("Use an empty sessionStorage area.");
    }

    try {
      console.log(storage.length);
      storage.setItem("theme", "dark");
      storage.setItem("lang", "en");

      const count = storage.length;
      const names = [];
      for (let index = 0; index < count; index++) {
        const name = storage.key(index);
        if (name !== null) names.push(name);
      }

      console.log(count);
      console.log(JSON.stringify(names.sort().map(name => [name, storage.getItem(name)])));
      console.log(storage.key(count));
    } finally {
      storage.removeItem("theme");
      storage.removeItem("lang");
    }
  }

  const storage = globalThis.sessionStorage;
  if (storage !== undefined) {
    demonstrate(storage);
  } else {
    // If Node.js 24 has not exposed Web Storage, enable it in a fresh process.
    const { execFileSync } = require("node:child_process");
    execFileSync(
      process.execPath,
      ["--experimental-webstorage", "-e", `(${demonstrate.toString()})(globalThis.sessionStorage);`],
      { stdio: "inherit" },
    );
  }
})();

Rezultat

0
2
[["lang","en"],["theme","dark"]]
null

Pokreni kôd u konzoli preglednika na stranici HTTP(S), u testnoj kartici s praznim i dostupnim `sessionStorage` koji ne mijenja drugi kôd. Sortiranje daje ispis neovisan o redoslijedu ključeva u pregledniku. `key(count)` vraća `null`, a `finally` uklanja samo dvije stavke koje primjer koristi. Za Node.js 24 spremi kôd kao `main.js` i pokreni `node main.js`; primjer po potrebi omogućuje ugrađeni Web Storage u podređenom procesu.

Povezane lekcije

  • JavaScript · Lekcija 42 · Napredno · Verzija: 4

Izvori