Window: localStorage-Eigenschaft
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die localStorage schreibgeschützte Eigenschaft des window-Interfaces ermöglicht Ihnen den Zugriff auf ein Storage-Objekt für den Ursprung des Dokuments; die gespeicherten Daten werden über Browsersitzungen hinweg gespeichert.
localStorage ist ähnlich wie sessionStorage, außer dass localStorage-Daten kein Ablaufdatum haben, während sessionStorage-Daten gelöscht werden, wenn die Seitensitzung endet — das heißt, wenn die Seite geschlossen wird. (localStorage-Daten für ein Dokument, das in einem "privaten Browsing" oder "Inkognito"-Modus geladen wird, werden gelöscht, wenn der letzte "private" Tab geschlossen wird.)
Wert
Ein Storage-Objekt, das verwendet werden kann, um auf den lokalen Speicherbereich des aktuellen Ursprungs zuzugreifen.
Ausnahmen
SecurityError-
Wird in einem der folgenden Fälle ausgelöst:
- Der Ursprung ist kein gültiges Schema/Host/Port-Tupel. Dies kann beispielsweise passieren, wenn der Ursprung die
file:oderdata:-Schemen verwendet. - Die Anfrage verstößt gegen eine Richtlinie. Zum Beispiel hat der Benutzer den Browser so konfiguriert, dass die Seite keine Daten speichern darf.
Beachten Sie, dass wenn der Benutzer Cookies blockiert, die Browser dies wahrscheinlich als Anweisung interpretieren, die Seite daran zu hindern, Daten zu speichern.
- Der Ursprung ist kein gültiges Schema/Host/Port-Tupel. Dies kann beispielsweise passieren, wenn der Ursprung die
Beschreibung
Die Schlüssel und Werte, die mit localStorage gespeichert werden, sind im UTF-16-String-Format. Wie bei Objekten werden ganze Zahlenschlüssel automatisch in Strings umgewandelt.
localStorage-Daten sind spezifisch für das Protokoll des Dokuments. Insbesondere für eine über HTTP geladene Seite (z.B. http://example.com) gibt localStorage ein anderes Objekt zurück als localStorage für die entsprechende Seite, die über HTTPS geladen wird (z.B. https://example.com).
Für Dokumente, die aus file: URLs geladen werden (d.h. Dateien, die direkt vom lokalen Dateisystem des Benutzers im Browser geöffnet werden, anstatt von einem Webserver bereitgestellt zu werden), sind die Anforderungen an das Verhalten von localStorage undefiniert und können zwischen verschiedenen Browsern variieren.
In allen aktuellen Browsern scheint localStorage ein anderes Objekt für jede file: URL zurückzugeben. Mit anderen Worten, jede file: URL scheint ihren eigenen einzigartigen lokalen Speicherbereich zu haben. Es gibt jedoch keine Garantien für dieses Verhalten, daher sollten Sie sich nicht darauf verlassen, denn wie oben erwähnt, bleiben die Anforderungen für file: URLs undefiniert. Es ist möglich, dass Browser ihr file: URL-Handling für localStorage jederzeit ändern. Tatsächlich haben einige Browser ihr Handling dafür im Laufe der Zeit geändert.
Beispiele
Das folgende Snippet greift auf das lokale Storage-Objekt der aktuellen Domäne zu und fügt einen Datenpunkt hinzu, indem Storage.setItem() verwendet wird.
localStorage.setItem("myCat", "Tom");
Die Syntax zum Lesen des localStorage-Elements ist wie folgt:
const cat = localStorage.getItem("myCat");
Die Syntax zum Entfernen des localStorage-Elements ist wie folgt:
localStorage.removeItem("myCat");
Die Syntax zum Entfernen aller localStorage-Elemente ist wie folgt:
localStorage.clear();
Hinweis: Bitte beachten Sie den Artikel Verwendung der Web Storage API für ein vollständiges Beispiel.
Spezifikationen
| Specification |
|---|
| HTML # dom-localstorage-dev |