Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Storage.length a Storage.key(): počet položiek a čítanie názvov kľúčov

`length` udáva počet uložených položiek a `key(index)` vracia názov kľúča podľa jeho pozície. Poradie kľúčov nie je zaručené.

Verzia: Current web platform; runtime support varies

Syntax

// 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čuje dva prvky inštancie Storage. Vlastnosť storage.length je len na čítanie a udáva aktuálny počet dvojíc kľúč–hodnota, nie veľkosť v bajtoch ani kvótu. Metóda storage.key(index) vracia názov kľúča ako reťazec, nie jeho hodnotu. Pozície sa začínajú od nuly: zadajte nezáporné celé číslo v rozsahu unsigned long (od 0 do 2 ** 32 - 1). Ak je skonvertovaný index väčší alebo rovný aktuálnej hodnote length, metóda vráti null.

Ak chcete prečítať hodnotu, odovzdajte názov metóde storage.getItem(name). Aj tá môže vrátiť null, ale v tomto prípade to znamená, že daný kľúč neexistuje. Výsledok key() overte pomocou name !== null, pretože aj prázdny reťazec môže byť platným názvom kľúča.

Poradie kľúčov závisí od implementácie a po zmene obsahu sa môže zmeniť. Nespoliehajte sa na poradie vkladania a neukladajte index ako identifikátor kľúča. Ak záleží na poradí zobrazenia, zozbierajte názvy a explicitne ich zoraďte. Uložením length nevznikne snímka úložiska: zmeny počas prechádzania môžu spôsobiť, že niektoré kľúče preskočíte alebo ich navštívite dvakrát.

Rozhranie Web Storage definuje štandard HTML, nie ECMAScript 2024. window.localStorage je viazané na pôvod (origin) a môže pretrvať reštart prehliadača. window.sessionStorage je navyše oddelené podľa kariet alebo okien najvyššej úrovne: pretrvá opätovné načítanie stránky, no je viazané na reláciu stránky. Nepredpokladajte dostupnosť v každom prostredí. Získanie ktoréhokoľvek objektu úložiska môže vyvolať SecurityError pri nepriehľadnom pôvode alebo v dôsledku pravidiel prehliadača. Zápis môže vyvolať QuotaExceededError, napríklad pri vyčerpaní kvóty.

Príklady

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

Výsledok

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

Spustite kód v konzole prehliadača na stránke HTTP(S) v testovacej karte s prázdnym a dostupným `sessionStorage`, ktoré nemení žiadny iný kód. Zoradením sa výstup stane nezávislým od poradia kľúčov v prehliadači. `key(count)` vráti `null` a `finally` odstráni iba dve položky použité v príklade. Pre Node.js 24 uložte kód ako `main.js` a spustite `node main.js`. V prípade potreby príklad povolí vstavané rozhranie Web Storage v podriadenom procese.

Súvisiace lekcie

  • JavaScript · Lekcia 42 · Pokročilá · Verzia: 4

Zdroje