Window.sessionStorage

Über die Eigenschaft sessionStorage kann auf ein Sitzungs-Storage Objekt zugegriffen werden. sessionStorage ist ähnlich dem Window.localStorage. Gegenüber dem localStorage, für dessen gespeicherten Daten kein Ablaufdatum gesetzt ist, werdem alle Daten des sessionStorage gelöscht, sobald die Page Session beendet ist. Eine Page Session besteht solange, wie der Browser geöffnet ist und übersteht das Neuladen und Wiederherstellen einer Webseite. Das Öffnen einer Webseite in einem neuen Tab oder Browserfenster erzeugt eine neue Sitzung; ein Unterschied zur Funktionsweise von Cookies.

Syntax

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

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

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. Wenn die Seite versehentlich aktualisiert wird, wird der Inhalt wiederhergestellt sodass keine Informationen 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
Web Storage (Second edition)
Die Definition von 'sessionStorage' in dieser Spezifikation.
Empfehlung  

Browser Kompatibilität

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
localStorage 4 3.5 8 10.50 4
sessionStorage 5 2 8 10.50 4
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 2.1 ? 8 11 iOS 3.2

Jeder Browser hat unterschiedliche Speicherkapazitäten für localStorage und sessionStorage. Hier können Details für unterschiedliche Browser gefunden werden: detailed rundown of all the storage capacities for various browsers.

Anmerkung: Ab iOS 5.1 speichert Safari Mobile Daten des localStorage im Cache Ordner, der gelegentlich durch das OS geleert wird, typischerweise, wenn Speicher knapp wird.

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

 Mitwirkende an dieser Seite: HendrikRunte, occcy
 Zuletzt aktualisiert von: HendrikRunte,