WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Storage.setItem — Werte speichern und ersetzen

Storage.setItem speichert Text unter einem Schlüssel in localStorage oder sessionStorage und ersetzt dabei den vorherigen Wert. Ein Schreibvorgang kann fehlschlagen; berücksichtige daher Ausnahmen und Einschränkungen beim Zugriff.

Version: 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)

Rufe Storage.setItem auf einem localStorage- oder sessionStorage-Objekt auf: storage.setItem(key, value). Die Methode erstellt einen Eintrag oder ersetzt den Wert eines vorhandenen Schlüssels und gibt undefined zurück. Diese API gehört zum HTML-Standard und ist kein Merkmal einer bestimmten ECMAScript-Version. Moderne Browser-Engines unterstützen sie; dass sich Node 24 in einem Repository befindet, belegt nicht die Verfügbarkeit einer Browser-API.

Schlüssel und Werte werden in Zeichenketten umgewandelt. Um ein Objekt zu speichern, serialisiere es ausdrücklich zu einer Zeichenkette. Beim Auslesen des gespeicherten Werts liefert der Speicher eine Zeichenkette, die die Anwendung entsprechend dem beim Schreiben verwendeten Format dekodieren muss. Wenn du mit JSON.stringify JSON schreibst, verwende JSON.parse, um diese Zeichenkette zu dekodieren. localStorage speichert Daten für einen Origin über mehrere Sitzungen hinweg; sessionStorage ist zusätzlich nach dem obersten Browsing-Kontext getrennt, normalerweise nach Tab. Daten können gelöscht werden.

Ein fehlgeschlagener Schreibvorgang kann QuotaExceededError auslösen; schon der Zugriff auf den Speicher kann SecurityError auslösen. Verwende für Zugriff und Schreibvorgang try/catch, wenn die Anwendung auch ohne Speicher funktionieren soll. Das Schreiben derselben Zeichenkette ändert nichts. Die storage-Benachrichtigung richtet sich an andere berechtigte Dokumente, nicht an das Fenster, das den Schreibvorgang ausführt.

Beispiele

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

Ergebnis

first
second

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen