KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Storage.getItem — een Web Storage-waarde lezen

Storage.getItem(key) leest synchroon tekst uit localStorage of sessionStorage. De methode geeft null terug als de sleutel niet bestaat; een lege tekenreeks is een bestaande waarde en geen ontbrekende vermelding.

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.getItem(key)

Storage.getItem is een instantiemethode van Storage die wordt gebruikt door localStorage en sessionStorage. De methode accepteert een tekstreeks als sleutel en geeft de opgeslagen tekst terug, of null als de vermelding niet bestaat. Lezen gebeurt synchroon en verwijdert de vermelding niet.

Maak onderscheid tussen null, "" en "null". Controleer of een waarde ontbreekt met value === null, niet met !value, want dat komt ook overeen met een lege tekenreeks. Opgeslagen getallen en objecten krijgen hun oorspronkelijke typen niet automatisch terug.

Dit is een Web-API die is gedefinieerd in de HTML Living Standard, geen functie van een bepaalde ECMAScript-editie. Moderne browsers ondersteunen de API breed; de Node-versie van de repository toont geen browserondersteuning aan. Alleen al toegang tot window.localStorage of window.sessionStorage kan een SecurityError veroorzaken door een ondoorzichtige origin of browserbeleid.

Het voorbeeld maakt onderscheid tussen een lege tekenreeks, de tekenreeks "42" en een ontbrekende vermelding. Het kiest een ongebruikte sleutel en verwijdert de tijdelijke vermelding om te controleren of het lezen null oplevert. Het finally-blok herhaalt de verwijdering om ook bij een fout op te ruimen, zonder de volledige opslag leeg te maken.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.getItem: empty and missing values</title>
</head>
<body>
<h1>Reading a storage value</h1>
<p id="source"></p>
<script>
  function readValues(storage) {
    let key = 'cktis:getItem';
    while (storage.getItem(key) !== null) key += ':';

    try {
      storage.setItem(key, '');
      const empty = storage.getItem(key);
      storage.setItem(key, '42');
      const text = storage.getItem(key);
      storage.removeItem(key);
      return [JSON.stringify(empty), JSON.stringify(text), storage.getItem(key) === null];
    } finally {
      storage.removeItem(key);
    }
  }

  let lines;
  let source = 'Using browser sessionStorage.';
  try {
    lines = readValues(window.sessionStorage);
  } catch (error) {
    if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
    source = error.name === 'QuotaExceededError'
      ? 'Could not write the demo value to sessionStorage. Existing entries may still be readable. Using an in-memory fixture, not Web Storage.'
      : 'Browser storage is unavailable. Using an in-memory fixture, not Web Storage.';
    const entries = new Map();
    lines = readValues({
      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

""
"42"
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