Storage: setItem() Methode
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 setItem() Methode der Storage
Schnittstelle, fügt einen Schlüssel zu dem angegebenen Storage-Objekt hinzu, wenn ihr ein Schlüsselname und ein Wert übergeben werden, oder aktualisiert den Wert dieses Schlüssels, falls er bereits existiert.
Syntax
setItem(keyName, keyValue)
Parameter
Rückgabewert
Keiner (undefined).
Ausnahmen
QuotaExceededError-
Wird ausgelöst, wenn der Speicherplatz erschöpft ist oder der Benutzer Ihnen nicht mehr Speicherplatz gewährt hat.
Beispiele
Die folgende Funktion erstellt drei Datenobjekte im lokalen Speicher.
function populateStorage() {
localStorage.setItem("bgcolor", "red");
localStorage.setItem("font", "Helvetica");
localStorage.setItem("image", "myCat.png");
}
Hinweis: Um dies in einem realen Beispiel zu sehen, besuchen Sie unser Web Storage Demo.
Storage unterstützt nur das Speichern und Abrufen von Strings. Wenn Sie andere Datentypen speichern möchten, müssen Sie diese in Strings umwandeln. Für einfache Objekte und Arrays können Sie JSON.stringify() verwenden.
const person = { name: "Alex" };
localStorage.setItem("user", person);
console.log(localStorage.getItem("user")); // "[object Object]"; not useful!
localStorage.setItem("user", JSON.stringify(person));
console.log(JSON.parse(localStorage.getItem("user"))); // { name: "Alex" }
Es gibt jedoch keinen generischen Weg, um beliebige Datentypen zu speichern. Zudem ist das abgerufene Objekt eine Tiefenkopie des ursprünglichen Objekts und Änderungen daran wirken sich nicht auf das ursprüngliche Objekt aus.
Spezifikationen
| Specification |
|---|
| HTML # dom-storage-setitem-dev |
Browser-Kompatibilität
Loading…