Window: sessionStorage-Eigenschaft

BaselineWidely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die schreibgeschützte EigenschaftsessionStorage greift auf ein sessionStorage-Objekt für den aktuellenOrigin zu.sessionStorage ist ähnlich wielocalStorage; der Unterschied besteht darin, dasslocalStorage nur nach dem Origin partitioniert ist, währendsessionStorage sowohl nach Origin als auch nach Browser-Tabs (Top-Level-Browsing-Kontexte) partitioniert ist. Die Daten insessionStorage werden nur für die Dauer der Sitzung der Seite aufbewahrt.

Jedes Mal, wenn ein Dokument in einem bestimmten Tab im Browser geladen wird, wird eine einzigartige Sitzung der Seite erstellt und diesem spezifischen Tab zugewiesen. Diese Sitzung der Seite ist nur in diesem spezifischen Tab zugänglich. Das Hauptdokument und alle eingebettetenBrowsing-Kontexte (iframes) werden nach ihrem Origin gruppiert, und jeder Origin hat Zugriff auf seinen eigenen separaten Speicherbereich.
Wenn die Seite eineopener hat, ist diesessionStorage anfänglich eine Kopie dessessionStorage-Objekts des Openers. Sie bleiben jedoch getrennt, und Änderungen an einer haben keinen Einfluss auf die andere. Um zu verhindern, dass diesessionStorage kopiert wird, verwenden Sie eine der Techniken, die denopener entfernen (sieheWindow.opener).
Eine Sitzung der Seite dauert, solange der Tab oder der Browser geöffnet ist, und überlebt Seiten-Neuladungen und -Wiederherstellungen.
Das Öffnen einer Seite in einem neuen Tab oder Fenster erstellt eine neue Sitzung mit dem Wert des Top-Level-Browsing-Kontextes, was sich von der Funktionsweise der Sitzungs-Cookies unterscheidet.
Das Schließen des Tabs/Fensters beendet die Sitzung und löscht die Daten insessionStorage.

Wert

EinStorage-Objekt, das verwendet werden kann, um auf den Sitzungsspeicherraum des aktuellen Origins zuzugreifen.

Ausnahmen

SecurityError

Wird in einem der folgenden Fälle ausgelöst:

Der Origin ist keingültiges Schema/Host/Port-Tupel. Dies kann passieren, wenn der Origin beispielsweise diefile:- oderdata:-Schemata verwendet.
Die Anfrage verstößt gegen eine Richtlinienentscheidung. Zum Beispiel hat der Benutzer den Browser so konfiguriert, dass er der Seite verbietet, Daten zu speichern.

Beachten Sie, dass, wenn der Benutzer Cookies blockiert, die Browser dies wahrscheinlich als Anweisung interpretieren, der Seite zu verbieten, Daten zu speichern.

Beispiele

Grundlegende Verwendung

// Save data to sessionStoragesessionStorage.setItem("key", "value");// Get saved data from sessionStoragelet data = sessionStorage.getItem("key");// Remove saved data from sessionStoragesessionStorage.removeItem("key");// Remove all saved data from sessionStoragesessionStorage.clear();

Speicherung von Text zwischen Aktualisierungen

Das folgende Beispiel speichert den Inhalt eines Textfeldes automatisch, und wenn der Browser aktualisiert wird, stellt es den Inhalt des Textfeldes wieder her, sodass kein Text verloren geht.

// Get the text field that we're going to tracklet field = document.getElementById("field");// See if we have an autosave value// (this will only happen if the page is accidentally refreshed)if (sessionStorage.getItem("autosave")) {  // Restore the contents of the text field  field.value = sessionStorage.getItem("autosave");}// Listen for changes in the text fieldfield.addEventListener("change", () => {  // And save the results into the session storage object  sessionStorage.setItem("autosave", field.value);});

Hinweis:Bitte konsultieren Sie den ArtikelUsing the Web Storage API für ein vollständiges Beispiel.