WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Browserspeicher

Browserspeicher umfasst Funktionen der Browserumgebung, mit denen Daten clientseitig gespeichert werden. Lerne den Unterschied zwischen localStorage und sessionStorage sowie die Grenze zwischen der ECMAScript-Sprache und Web-APIs kennen.

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

localStorage.setItem(key, value);
localStorage.getItem(key);
localStorage.removeItem(key);

Browserspeicher (browser storage) ist eine Funktion der Umgebung und keine ECMAScript-Syntax. Die ECMAScript-Spezifikation beschreibt die Sprache und ihre Interaktion mit der Hostumgebung; sie definiert weder localStorage noch sessionStorage. Dass Node 24 in einem Repository vorhanden ist, belegt nicht, dass diese Schnittstellen im Zielbrowser verfügbar sind.

localStorage speichert Schlüssel-Wert-Paare sitzungsübergreifend, während sessionStorage an die Seitensitzung in einem bestimmten Tab gebunden ist. Beide Schnittstellen arbeiten synchron und speichern Zeichenfolgen. getItem(key) gibt null zurück, wenn der Schlüssel fehlt. Objekte lassen sich mit JSON.stringify speichern und mit JSON.parse auslesen.

Der Zugriff hängt vom Ursprung der Seite und den Richtlinien des Browsers ab. Daten können gelöscht werden, und Zugriffe oder Schreibvorgänge können einen Fehler auslösen. Betrachte diesen Speicher weder als einzige Datenkopie noch als Ort für Geheimnisse. Der Abschnitt Web Storage des WHATWG-HTML-Standards definiert localStorage und sessionStorage sowie ihre Methoden. Er ist jedoch kein Nachschlagewerk zur Browserkompatibilität und garantiert nicht, dass diese Schnittstellen im Zielbrowser verfügbar sind.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Browser storage example</title>
</head>
<body>
  <p>localStorage can persist across visits. sessionStorage is scoped to the page session in a tab. Both are browser APIs, not part of ECMAScript.</p>
  <ul aria-label="Storage check results">
    <li id="localStorage"></li>
    <li id="sessionStorage"></li>
  </ul>
  <script>
    const fixture = JSON.stringify({ theme: 'dark' });

    function checkStorage(name) {
      const result = document.getElementById(name);
      try {
        const store = window[name];
        // A fresh temporary key avoids reusing application keys. This sequence is not atomic:
        // another same-origin tab can change localStorage between calls.
        const key = `cktis:storage:example:${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
        if (store.getItem(key) !== null) {
          throw new Error('Temporary storage key already exists');
        }
        store.setItem(key, fixture);
        let saved;
        try {
          saved = store.getItem(key);
        } finally {
          store.removeItem(key);
        }
        if (saved !== fixture || store.getItem(key) !== null) {
          throw new Error('Round trip or cleanup failed');
        }
        result.textContent = `${name}: read back theme=${JSON.parse(saved).theme}; temporary key removed.`;
      } catch (error) {
        if (!(error instanceof DOMException) || !['SecurityError', 'QuotaExceededError'].includes(error.name)) {
          throw error;
        }
        result.textContent = `${name}: temporary write unavailable (${error.name}).`;
      }
      console.log(result.textContent);
    }

    checkStorage('localStorage');
    checkStorage('sessionStorage');
  </script>
</body>
</html>

Ergebnis

A successful check reports that it read back theme=dark and removed the temporary key. If the check catches a DOMException named SecurityError or QuotaExceededError, it reports that the temporary write is unavailable and includes the error name. Other errors, including a temporary-key collision or a detected round-trip or cleanup failure, are rethrown without a report for that storage area. If the localStorage check rethrows, the sessionStorage check does not run.

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