KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Storage.setItem — een waarde opslaan en vervangen

Storage.setItem slaat tekst op onder een sleutel in localStorage of sessionStorage en vervangt daarbij de vorige waarde. Een schrijfactie kan mislukken, dus houd rekening met uitzonderingen en beperkingen op de toegang tot de opslag.

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.setItem(key, value)

Roep Storage.setItem aan op een localStorage- of sessionStorage-object: storage.setItem(key, value). De methode maakt een item aan of vervangt de waarde van een bestaande sleutel en retourneert undefined. Dit is een API uit de HTML-standaard, niet een functie van een bepaalde ECMAScript-editie. Moderne browser-engines ondersteunen de API; de aanwezigheid van Node 24 in een repository bewijst niet dat een browser-API beschikbaar is.

Sleutels en waarden worden omgezet naar tekenreeksen. Als je een object wilt opslaan, serialiseer het dan expliciet tot een tekenreeks. Bij het uitlezen van de opgeslagen waarde geeft de opslag een tekenreeks terug die de toepassing moet decoderen volgens het formaat dat bij het schrijven is gebruikt. Als je JSON wegschrijft met JSON.stringify, gebruik dan JSON.parse om die tekenreeks te decoderen. localStorage bewaart gegevens voor een origin tussen sessies, terwijl sessionStorage ook wordt gescheiden per context op het hoogste navigatieniveau, meestal een tabblad. Gegevens kunnen worden verwijderd.

Een mislukte schrijfactie kan QuotaExceededError veroorzaken; toegang tot de opslag zelf kan SecurityError veroorzaken. Gebruik try/catch rond zowel de toegang als het schrijven als de toepassing ook zonder opslag moet werken. Dezelfde tekst opnieuw schrijven verandert niets. De storage-melding is bedoeld voor andere daarvoor in aanmerking komende documenten, niet voor het venster dat schrijft.

Voorbeelden

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.setItem: writing and replacing text</title>
</head>
<body>
<h1>Replacing a storage value</h1>
<p id="source"></p>
<script>
  function writeValues(storage) {
    let key = 'cktis:setItem';
    while (storage.getItem(key) !== null) key += ':';

    try {
      storage.setItem(key, 'first');
      const before = storage.getItem(key);
      storage.setItem(key, 'second');
      return [before, storage.getItem(key)];
    } finally {
      storage.removeItem(key);
    }
  }

  let lines;
  let source = 'Using browser sessionStorage.';
  try {
    lines = writeValues(window.sessionStorage);
  } catch (error) {
    if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
    source = 'Browser storage is unavailable. Using an in-memory fixture, not Web Storage.';
    const entries = new Map();
    lines = writeValues({
      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

first
second

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