Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Storage: počítání položek a čtení názvů klíčů

Storage zpřístupňuje řetězcové dvojice klíč–hodnota prostřednictvím localStorage a sessionStorage. Poznejte rozdíl mezi Storage.length, která počítá položky, a Storage.key(index), která vrací název klíče, nikoli jeho hodnotu.

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

Syntaxe

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

Storage je rozhraní Web API definované standardem HTML, nikoli ECMAScriptem. Jeho objekty získáte přes window.localStorage nebo window.sessionStorage. První slouží k ukládání dat i po skončení aktuální relace; druhý je svázán s relací a původem karty. Klíče i hodnoty jsou řetězce.

Storage.length je pouze pro čtení: udává počet dvojic, nikoli jejich velikost v bajtech. Při volání Storage.key(index) Web IDL nejprve převede argument na typ unsigned long. Metoda použije převedenou hodnotu jako index počítaný od nuly a vrátí název klíče, nebo null, pokud je tento index větší nebo roven length. Například storage.key(2 ** 32) použije index 0 a vrátí název klíče, pokud úložiště není prázdné. Hodnotu přečtete pomocí getItem(key).

Pořadí klíčů není určeno a při změnách se může měnit. Nepředpokládejte pořadí vložení a při procházení podle indexu položky neodstraňujte. Pro opakovatelný výpis názvy shromážděte a seřaďte.

Přístup může vyvolat SecurityError a zápis může vyvolat QuotaExceededError. V aplikacích tyto chyby ošetřete. Příklad se nejprve pokusí použít window.sessionStorage. Pokud zachytí SecurityError nebo QuotaExceededError, použije místo Web Storage testovací úložiště v paměti a vypíše do konzole stejný výsledek. Přítomnost Node 24 v repozitáři nedokládá podporu tohoto Web API.

Pří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ýsledek

2
2
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje