Die schreibgeschütztesessionStorage-Eigenschaft greift auf ein Sitzungs-Storage-Objekt für den aktuellenUrsprung zu.sessionStorage ähnelt derlocalStorage; der Unterschied besteht darin, dasslocalStorage nur nach Ursprung partitioniert ist, währendsessionStorage sowohl nach Ursprung als auch nach Browser-Tabs (oberste 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 eindeutige Sitzung der Seite erstellt und diesem bestimmten Tab zugewiesen. Diese Sitzung der Seite ist nur in diesem bestimmten Tab zugänglich. Das Hauptdokument und alle eingebettetenBrowsing-Kontexte (iframes) werden nach ihrem Ursprung gruppiert, und jeder Ursprung hat Zugang zu seinem eigenen separaten Speicherbereich.
• Wenn die Seite einenopener hat, ist dassessionStorage anfangs eine Kopie dessessionStorage-Objekts des Openers. Sie sind jedoch weiterhin getrennt, und Änderungen an einem wirken sich nicht auf das andere aus. Um zu verhindern, dass dassessionStorage kopiert wird, verwenden Sie eine der Techniken, die denopener entfernen (sieheWindow.opener).
• Eine Sitzung der Seite dauert so lange, wie der Tab oder der Browser geöffnet ist, und übersteht Seitenaktualisierungen und -wiederherstellungen.
• Das Öffnen einer Seite in einem neuen Tab oder Fenster erstellt eine neue Sitzung mit dem Wert des obersten Browsing-Kontextes, was sich von der Funktionsweise von Sitzungscookies unterscheidet.
• Das Schließen des Tabs/Fensters beendet die Sitzung und löscht die Daten insessionStorage.

Wert

EinStorage-Objekt, das zum Zugriff auf den Speicherbereich der aktuellen Ursprungs-Sitzung verwendet werden kann.

Ausnahmen

SecurityError

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

• Der Ursprung ist keingültiges Schema/Host/Port-Tupel. Dies kann passieren, wenn der Ursprung diefile:- oderdata:-Schemen verwendet, zum Beispiel.
• Die Anfrage verstößt gegen eine Richtlinienentscheidung. Beispielsweise hat der Benutzer die Browser so konfiguriert, dass die Seite keine Daten speichern darf.

Beachten Sie, dass wenn der Benutzer Cookies blockiert, dies von den Browsern wahrscheinlich als Anweisung interpretiert wird, die Seite daran zu hindern, 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();

Text zwischen Aktualisierungen speichern

Das folgende Beispiel speichert den Inhalt eines Textfeldes automatisch und stellt bei Aktualisierung des Browsers den Inhalt des Textfeldes wieder her, sodass kein Schreibvorgang 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);});

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Verwendung der Web Storage API
• Window.localStorage