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 July 2015.
Die localStorage Lese-Eigenschaft des window-Interfaces ermöglicht Ihnen den Zugriff auf ein Storage-Objekt für den Ursprung des Document; die gespeicherten Daten werden über Browser-Sitzungen hinweg gespeichert.
localStorage ist ähnlich wie sessionStorage, außer dass localStorage-Daten keine Ablaufzeit 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 einer "privaten" oder "Inkognito"-Sitzung geladen wurde, 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 passieren, wenn der Ursprung beispielsweise die Schemas
file:oderdata:verwendet. - Die Anfrage verletzt eine Richtlinienentscheidung. Zum Beispiel, wenn der Benutzer den Browser so konfiguriert hat, dass verhindert wird, dass die Seite Daten speichert.
Beachten Sie, dass wenn der Benutzer Cookies blockiert, Browser dies wahrscheinlich als Anweisung interpretieren werden, zu verhindern, dass die Seite Daten speichert.
- Der Ursprung ist kein gültiges Schema/Host/Port-Tupel. Dies kann passieren, wenn der Ursprung beispielsweise die Schemas
Beschreibung
Die mit localStorage gespeicherten Schlüssel und Werte sind im UTF-16-String-Format. Wie bei Objekten werden Ganzzahlschlüssel automatisch in Strings umgewandelt.
localStorage-Daten sind spezifisch für das Protokoll des Dokuments. Insbesondere für eine Seite, die über HTTP geladen wird (z.B. http://example.com), liefert localStorage ein anderes Objekt als localStorage für die entsprechende Seite, die über HTTPS geladen wird (z.B. https://example.com).
Für Dokumente, die von file: URLs geladen werden (d.h. Dateien, die im Browser direkt vom lokalen Dateisystem des Benutzers geöffnet werden, anstatt von einem Webserver bereitgestellt zu werden), sind die Anforderungen an das localStorage-Verhalten undefiniert und können je nach Browser variieren.
In allen aktuellen Browsern scheint localStorage für jede file: URL ein anderes Objekt zurückzugeben. Mit anderen Worten, jede file: URL scheint ihren eigenen, einzigartigen lokalen Speicherbereich zu haben. Aber es gibt 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 also möglich, dass Browser ihr file: URL-Handling für localStorage jederzeit ändern könnten. Tatsächlich haben einige Browser ihr Handling im Laufe der Zeit geändert.
Beispiele
Das folgende Code-Snippet greift auf das aktuelle Storage-Objekt der aktuellen Domain zu und fügt ein Datenelement mithilfe von Storage.setItem() hinzu.
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 beziehen Sie sich auf den Artikel Using the Web Storage API für ein vollständiges Beispiel.
Spezifikationen
| Specification |
|---|
| HTML # dom-localstorage-dev |