Abschnitt 17 · Lektion 1
localStorage
Die Wahl zwischen hell und dunkel soll das Neuladen überleben. Bisher war danach alles weg, was der Code sich gemerkt hat, denn Variablen leben, solange die Seite lebt, und keine Sekunde länger. localStorage ist ein kleiner Kasten, in dem etwas liegen bleibt, über das Neuladen, das Schließen des Tabs und den Neustart des Rechners hinaus.
Fünf Zugriffe, mehr gibt es nicht
<p>Nach dem Neuladen steht in der ersten Zeile der Console, was vom letzten Lauf übrig ist.</p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
} console.log("Vom letzten Lauf übrig:", localStorage.getItem("profil:name"));
localStorage.setItem("profil:name", "Mario");
localStorage.setItem("profil:kurs", "javascript");
console.log("name:", localStorage.getItem("profil:name"));
console.log("Anzahl der Einträge:", localStorage.length);
console.log("Der erste Schlüssel heißt:", localStorage.key(0));
localStorage.removeItem("profil:kurs");
console.log("kurs nach removeItem:", localStorage.getItem("profil:kurs"));
console.log("Anzahl jetzt:", localStorage.length);
// clear leert alles. In einer echten Anwendung ist das grob:
// dort liegen auch die Einträge anderer Teile der Seite.
localStorage.clear();
console.log("Anzahl nach clear:", localStorage.length);
// Und noch einmal etwas ablegen, damit beim nächsten Lauf
// etwas da ist.
localStorage.setItem("profil:name", "Mario"); localStorage.setItem(schluessel, wert)legt etwas ab.localStorage.getItem(schluessel)holt es wieder.localStorage.removeItem(schluessel)löscht einen Eintrag.localStorage.clear()löscht alles, und zwar ohne nachzufragen. In einer echten Anwendung liegen dort auch die Einträge anderer Teile der Seite.localStorage.lengthundlocalStorage.key(n)sagen, wie viel drin ist und wie der Schlüssel an einer bestimmten Stelle heißt, wobei der Browser die Reihenfolge festlegt. Beides braucht man selten.
Beim ersten Lauf des ersten Beispiels steht in der ersten Zeile null. Nach einem Klick auf „Seite neu laden“ steht dort Mario. Dazwischen hat nur der Speicher durchgehalten, und bis jetzt war nach dem Neuladen jedes Mal alles weg.
In den Kasten kannst du jederzeit hineinsehen. In der Eingabezeile der Console antwortet localStorage.getItem("profil:name") mit "Mario", localStorage.length mit 1 und Object.keys(localStorage) mit (1) ["profil:name"]. Und localStorage allein zeigt den ganzen Bestand als {profil:name: "Mario"}. Das ist derselbe Kasten, in den der Code daneben geschrieben hat. Mit diesen vier Zeilen siehst du, was da eigentlich wirklich liegt, und diese Frage kommt in diesem Abschnitt ständig.
Alles ist Text
<p>Eine Zahl geht hinein, ein Text kommt heraus.</p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
} localStorage.setItem("profil:zaehler", 41);
localStorage.setItem("profil:angemeldet", false);
const zaehler = localStorage.getItem("profil:zaehler");
const angemeldet = localStorage.getItem("profil:angemeldet");
console.log("zaehler:", zaehler, typeof zaehler);
console.log("angemeldet:", angemeldet, typeof angemeldet);
// Und damit rechnet es sich schlecht.
console.log("Plus eins, falsch:", zaehler + 1);
console.log("Plus eins, richtig:", Number(zaehler) + 1);
// Der Wahrheitswert ist noch tückischer: der Text "false"
// ist nicht leer und damit truthy.
if (angemeldet) {
console.warn("Dieser Zweig läuft, obwohl false gespeichert wurde.");
}
console.log("Richtig geprüft:", angemeldet === "true"); Was hineingeht, kommt als Text zurück, immer und ohne Ausnahme.
Die Zahl 41 geht hinein, und der Text "41" kommt zurück. Rechnest du damit weiter, hängt + 1 einfach eine Eins an, und es steht "411" da. Der Fehler wirft nicht. Er rechnet nur falsch, und gesucht wird an der falschen Stelle.
Beim Wahrheitswert ist es noch unangenehmer. false geht hinein, "false" kommt zurück, und das ist ein nicht leerer Text und damit truthy. Ein if darauf läuft also in den falschen Zweig.
Der Ausweg ist immer derselbe. Beim Lesen wird zurückverwandelt, mit Number(...) für Zahlen und einem Vergleich mit === "true" für Wahrheitswerte. Für alles, was komplizierter ist, gibt es die nächste Lektion.
null, nicht undefined
<p>Ein Schlüssel, den nie jemand gesetzt hat.</p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
} const fehlt = localStorage.getItem("profil:gibtesnicht");
console.log("Wert:", fehlt);
console.log("Typ:", typeof fehlt);
console.log("Ist es undefined?", fehlt === undefined);
console.log("Ist es null?", fehlt === null);
// Deshalb greift ?? und liefert den Standardwert.
const sprache = localStorage.getItem("profil:sprache") ?? "de";
console.log("Sprache:", sprache);
// Der Unterschied zu ||. Ein absichtlich leerer
// Text wäre bei || weg, bei ?? bleibt er.
localStorage.setItem("profil:notiz", "");
console.log("Mit ??:", JSON.stringify(localStorage.getItem("profil:notiz") ?? "Standard"));
console.log("Mit ||:", JSON.stringify(localStorage.getItem("profil:notiz") || "Standard")); Fragst du nach einem Schlüssel, den es nicht gibt, bekommst du null zurück und nicht undefined, wie es ein Objekt bei einer fehlenden Eigenschaft liefern würde.
Praktisch ist der Unterschied meistens egal, denn ?? aus Lektion 3.4 greift bei beidem, und ein Ersatzwert ist damit eine Zeile lang.
Der Unterschied zu || zählt hier trotzdem. Ein absichtlich leerer Text ist ein gültiger gespeicherter Wert. || würde ihn durch den Ersatzwert ersetzen, ?? nicht. Im dritten Beispiel stehen beide Fassungen untereinander.
Der Kasten gehört zum Origin
localStorage gehört nicht zu einer einzelnen Seite, sondern zum Origin, also zur Kombination aus Protokoll, Domain und Port.
Daraus folgt zweierlei. Alle Seiten mit demselben Origin teilen sich denselben Speicher, und was auf der einen abgelegt wird, kannst du auf der anderen lesen. Mit und ohne www., mit http und mit https sind dabei schon verschiedene Origins. Den Speicher eines fremden Origins siehst du dagegen nicht, auch wenn dessen Seite in einem Rahmen auf deiner steckt.
Wenn sich alle Seiten denselben Kasten teilen, kollidieren Schlüssel wie name oder daten früher oder später. Ich gebe ihnen deshalb ein Präfix, so wie profil: in den Beispielen dieser Lektion.
Auf dieser Lernplattform liegt dort theme, also hell oder dunkel. Ist ein Fortschritt noch nicht beim Server angekommen, steht daneben lern:queue, die Warteschlange, und die verschwindet wieder, sobald der Server bestätigt hat. theme ist genau die Sorte Name, um die sich zwei Teile einer Seite irgendwann streiten. lern:queue hat sein Präfix.
Der Kasten, in den die Beispiele hier schreiben, ist übrigens nicht dieser, sondern ein eigener für jede Aufgabe und jedes Beispiel. Was es damit auf sich hat, steht in Lektion 17.3.
Kein Ablaufdatum
Ein Ablaufdatum, das sich setzen ließe, gibt es nicht. Aufgeräumt wird trotzdem, nur nicht vom eigenen Code. Safari löscht seit 2020 alles, was Skripte einer Seite abgelegt haben, wenn sie sieben Tage lang nicht angeklickt wurde, und ein privates Fenster nimmt beim Schließen alles mit.
Soll etwas nur eine Weile gelten, schreibst du den Zeitpunkt selbst dazu und prüfst beim Lesen, ob er noch gilt. Das ist kein großer Aufwand. Von allein passiert es aber nicht.
In der Aufgabe merkt sich die Seite eine Einstellung und stellt sie beim Laden wieder her.
Zum Mitnehmen
localStorage hebt Einträge über das Neuladen hinaus auf, und alles, was hineingeht, kommt als Text zurück. Ein fehlender Schlüssel liefert null, und den Kasten teilen sich alle Seiten desselben Origins.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe im Editor, direkt im Browser geprüft
Öffnet sich mit dem Basis Konto.