KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Storage: items tellen en sleutelnamen lezen

Storage biedt tekenreeksparen van sleutels en waarden via localStorage en sessionStorage. Leer het verschil tussen Storage.length, dat items telt, en Storage.key(index), dat een sleutelnaam teruggeeft in plaats van de waarde.

Versie: 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 is een Web API-interface die door HTML is gedefinieerd, niet door ECMAScript. Je krijgt de objecten via window.localStorage of window.sessionStorage. Het eerste is bedoeld voor opslag die langer duurt dan de huidige sessie; het tweede is gekoppeld aan de sessie en oorsprong van een tabblad. Sleutels en waarden zijn tekenreeksen.

Storage.length is alleen-lezen: de eigenschap geeft het aantal paren aan, niet hun grootte in bytes. Bij een aanroep van Storage.key(index) zet Web IDL het argument eerst om naar het type unsigned long. De methode gebruikt de omgezette waarde als index in een nummering die bij nul begint en geeft een sleutelnaam terug, of null als die index groter dan of gelijk aan length is. Zo gebruikt storage.key(2 ** 32) index 0 en geeft het een sleutelnaam terug als de opslag niet leeg is. Lees de waarde met getItem(key).

De volgorde van sleutels is niet vastgelegd en kan veranderen wanneer er wijzigingen plaatsvinden. Ga niet uit van de invoegvolgorde en verwijder geen items terwijl je op basis van indexen itereert. Verzamel de namen en sorteer ze voor een reproduceerbare weergave.

Toegang kan SecurityError veroorzaken en schrijven kan QuotaExceededError veroorzaken. Handel deze fouten in toepassingen af. Het voorbeeld probeert eerst window.sessionStorage te gebruiken. Als het SecurityError of QuotaExceededError opvangt, gebruikt het testopslag in het geheugen in plaats van Web Storage en schrijft het dezelfde uitvoer naar de console. De aanwezigheid van Node 24 in een repository toont niet aan dat deze Web API wordt ondersteund.

Voorbeelden

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

Resultaat

2
2
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen