Ü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.