Information Technology Reference
In-Depth Information
8.2.1 Das »Storage-Interface«
Das »Storage-Interface« definiert die gemeinsamen Attribute und Zugriffs-
methoden des persistenten Speichers. Egal ob es sich um ein sessionStorage
-
oder ein localStorage
-
Objekt handelt, beide beinhalten folgende Methoden
beziehungsweise Attribute:
Attribut/Methode
Rückgabewert
Beschreibung
length
integer
Anzahl der Schlüssel/Werte-Paare, die
diesem Objekt zugewiesen sind (Zugriff
nur lesend)
key(n)
DOMString
Name des Schlüssels an der Position
n
getItem(key)
data
Wert zum Schlüssel
key
(ein
DOMString
)
setItem(key,data)
void
speichert den Wert
data
zum Schlüssel
key.
removeItem(key)
void
löscht den Inhalt zum Schlüssel
key.
clear()
void
löscht alle Schlüssel/Werte-Paare die-
ses Objekts.
Tabelle 8.1:
Methoden und Attribute des Storage-Interface
Ähnlich den Cookies verwaltet das Storage-Interface Schlüssel/Werte-Paare,
wobei die Schlüssel vom Typ DOMString sind.
DOMString
s sind laut W3C-Spe-
zifikation in UTF-16 kodierte Zeichenketten, das bedeutet, man könnte sogar
Umlaute und andere Sonderzeichen in den Schlüsselwerten verwenden. Der
Konjunktiv wurde hier absichtlich gewählt, denn in aller Regel erspart man sich
Ärger, wenn man sich bei solchen Bezeichnungen auf Buchstaben und Zahlen
aus dem US-ASCII-Zeichensatz beschränkt. Auch eine leere Zeichenkette ist
ein gültiger Schlüssel, wobei diese Verwendung meist wohl nicht absichtlich
passiert. Wird ein bereits vorhandener Schlüssel in der
setItem
-Funktion ver-
wendet, so wird der bestehende Wert ersetzt.
Außer
setItem()
und
getItem()
bietet die
Web Storage API
aber noch eine ande-
re Zugriffsmöglichkeit, die in vielen Fällen einfacher zu lesen ist. Will man zum
Beispiel den Schlüssel
currentTemp
mit dem Wert
18
im
localStorage
-
Speicher
ablegen, so reicht folgende Zeile aus:
localStorage.currentTemp = 18;