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

CKTIS / JavaScript

Storage: počítanie položiek a čítanie názvov kľúčov

Storage sprístupňuje reťazcové dvojice kľúč–hodnota prostredníctvom localStorage a sessionStorage. Spoznajte rozdiel medzi Storage.length, ktorá počíta položky, a Storage.key(index), ktorá vracia názov kľúča, nie jeho hodnotu.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

storage.length
storage.key(index)
storage.getItem(key)
storage.setItem(key, value)
storage.removeItem(key)
storage.clear()

Storage je rozhranie Web API definované štandardom HTML, nie ECMAScriptom. Jeho objekty získate cez window.localStorage alebo window.sessionStorage. Prvý slúži na uchovávanie údajov aj po skončení aktuálnej relácie; druhý je viazaný na reláciu a pôvod karty. Kľúče aj hodnoty sú reťazce.

Storage.length je iba na čítanie: udáva počet dvojíc, nie ich veľkosť v bajtoch. Pri volaní Storage.key(index) Web IDL najprv prevedie argument na typ unsigned long. Metóda použije prevedenú hodnotu ako index počítaný od nuly a vráti názov kľúča alebo null, ak je tento index väčší alebo rovný length. Napríklad storage.key(2 ** 32) použije index 0 a vráti názov kľúča, ak úložisko nie je prázdne. Hodnotu prečítate pomocou getItem(key).

Poradie kľúčov nie je určené a pri zmenách sa môže meniť. Nepredpokladajte poradie vloženia a pri prechádzaní podľa indexu položky neodstraňujte. Ak chcete opakovateľné zobrazenie, názvy zhromaždite a zoraďte.

Prístup môže vyvolať SecurityError a zápis môže vyvolať QuotaExceededError. V aplikáciách tieto chyby ošetrite. Príklad sa najprv pokúsi použiť window.sessionStorage. Ak zachytí SecurityError alebo QuotaExceededError, namiesto Web Storage použije testovacie úložisko v pamäti a do konzoly vypíše rovnaký výsledok. Prítomnosť Node 24 v repozitári nedokazuje podporu tohto Web API.

Príklady

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage: counting entries and reading key names</title>
</head>
<body>
<h1>Counting storage entries and listing their keys</h1>
<p id="source"></p>
<script>
  function inspectStorage(storage) {
    const names = ['cktis:storage:a', 'cktis:storage:b'].map(base => {
      let name = base;
      let suffix = 0;
      while (storage.getItem(name) !== null) name = `${base}:${++suffix}`;
      return name;
    });
    const written = [];
    try {
      const before = storage.length;
      for (const [index, value] of ['10', '20'].entries()) {
        storage.setItem(names[index], value);
        written.push(names[index]);
      }

      const count = storage.length;
      const keys = [];
      for (let index = 0; index < count; index++) {
        const name = storage.key(index);
        if (names.includes(name)) keys.push(name);
      }
      return [count - before, keys.length, storage.key(count) === null];
    } finally {
      for (const name of written) storage.removeItem(name);
    }
  }

  let lines;
  let source = 'Using browser sessionStorage.';
  try {
    lines = inspectStorage(window.sessionStorage);
  } catch (error) {
    if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
    source = 'The browser storage test write is unavailable. Using an in-memory fixture for this demonstration.';
    const entries = new Map();
    lines = inspectStorage({
      get length() { return entries.size; },
      key(index) { return Array.from(entries.keys())[index] ?? null; },
      getItem(key) { return entries.has(key) ? entries.get(key) : null; },
      setItem(key, value) { entries.set(key, String(value)); },
      removeItem(key) { entries.delete(key); }
    });
  }
  document.getElementById('source').textContent = source;
  for (const line of lines) console.log(line);
</script>
</body>
</html>

Výsledok

2
2
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje