Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Storage: štetje vnosov in branje imen ključev

Storage prek localStorage in sessionStorage omogoča pare ključ–vrednost v obliki nizov. Spoznajte razliko med Storage.length, ki šteje vnose, in Storage.key(index), ki vrne ime ključa, ne njegove vrednosti.

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

Sintaksa

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

Storage je vmesnik Web API, ki ga določa HTML, ne ECMAScript. Njegove objekte pridobite prek window.localStorage ali window.sessionStorage. Prvi je namenjen shranjevanju podatkov tudi po koncu trenutne seje; drugi je vezan na sejo in izvor zavihka. Ključi in vrednosti so nizi.

Storage.length je samo za branje: podaja število parov, ne njihove velikosti v bajtih. Pri klicu Storage.key(index) Web IDL najprej pretvori argument v tip unsigned long. Metoda uporabi pretvorjeno vrednost kot indeks, štet od nič, in vrne ime ključa ali null, če je ta indeks večji ali enak length. Na primer, storage.key(2 ** 32) uporabi indeks 0 in vrne ime ključa, če shramba ni prazna. Vrednost preberete z getItem(key).

Vrstni red ključev ni določen in se lahko ob spremembah spremeni. Ne predpostavljajte vrstnega reda vstavljanja in med iteriranjem po indeksih ne odstranjujte vnosov. Za ponovljiv prikaz zberite imena in jih razvrstite.

Dostop lahko sproži SecurityError, zapisovanje pa lahko sproži QuotaExceededError. V aplikacijah obravnavajte ti napaki. Primer najprej poskusi uporabiti window.sessionStorage. Če prestreže SecurityError ali QuotaExceededError, namesto Web Storage uporabi preskusno shrambo v pomnilniku in v konzolo izpiše enak rezultat. Prisotnost Node 24 v repozitoriju ne dokazuje podpore za ta Web API.

Primeri

<!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>

Rezultat

2
2
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri