Die sessionStorage-Eigenschaft erlaubt den Zugriff auf ein nur während der aktuellen Sitzung verfügbares Storage-Objekt. sessionStorage ist mit einer Ausnahme identisch zu Window.localStorage: In localStorage gespeicherte Daten besitzen kein Verfallsdatum, während sie im sessionStorage mit Ablauf der Sitzung gelöscht werden. Eine Sitzung endet erst mit dem Schließen des Browsers, sie übersteht das Neuladen und Wiederherstellen einer Webseite. Das Öffnen einer Webseite in einem neuen Tab oder Browserfenster erzeugt jedoch eine neue Sitzung; ein Unterschied zur Funktionsweise von Session-Cookies.

localStorage und sessionStorage sind nicht nur von der Domain, sondern auch vom Protokoll abhängig, über das die Seite aufgerufen wurde. In http://example.com/ gespeicherte Daten stehen daher unter https://example.com nicht zur Verfügung.

Syntax

// Daten im sessionStorage speichern
sessionStorage.setItem('key', 'value');

// Gespeicherte Daten aus dem sessionStorage abfragen
var data = sessionStorage.getItem('key');

// Gespeicherte Daten aus dem sessionStorage entfernen
sessionStorage.removeItem('key');

// Alle gespeicherten Daten aus dem sessionStorage entfernen
sessionStorage.clear(); 

Wert

Ein Storage-Objekt.

Beispiel

Im folgenden Beispiel wird auf das sessionStorage-Objekt der aktuellen Domain zugegriffen und mit Storage.setItem() Daten hinzugefügt:

sessionStorage.setItem('myCat', 'Tom');

Das folgende Beispiel speichert automatisch den Inhalt eines Textfeldes. Bei einem versehentlichen Neuladen der Seite wird der Inhalt wiederhergestellt, sodass keine Eingaben verloren gehen.

// Das Textfeld holen, das überwacht werden soll
var field = document.getElementById("field");
 
// Prüfen, ob ein gespeicherter Wert vorliegt
// (das ist nur dann der Fall, wenn die Seite versehentlich aktualisiert wurde)
if (sessionStorage.getItem("autosave")) {
  // Den Inhalt des Testfeldes aus dem sessionStorage wiederherstellen
  field.value = sessionStorage.getItem("autosave");
}
 
// Änderungen des Inhalts des Textfeldes überwachen
field.addEventListener("change", function() {
  // Speichern des Inhalts des Textfeldes im sessionStorage
  sessionStorage.setItem("autosave", field.value);
});

Anmerkung: Ein vollständiges Beispiel kann unter Using the Web Storage API nachgelesen werden.

Spezifikationen

Spezifikation Status Bemerkung
Unknown
Die Definition von 'sessionStorage' in dieser Spezifikation.
Unbekannt  

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung Internet
sessionStorageChrome Vollständige Unterstützung 5Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 2IE Vollständige Unterstützung 8Opera Vollständige Unterstützung 10.5Safari Vollständige Unterstützung 4WebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung JaFirefox Android Vollständige Unterstützung JaOpera Android Vollständige Unterstützung 11Safari iOS Vollständige Unterstützung 3.2Samsung Internet Android Vollständige Unterstützung Ja

Legende

Vollständige Unterstützung  
Vollständige Unterstützung

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

Schlagwörter: 
Mitwirkende an dieser Seite: mdnwebdocs-bot, thunderhook, mdnde, filecage, HendrikRunte, occcy
Zuletzt aktualisiert von: mdnwebdocs-bot,