CKTIS / JavaScript
Storage.getItem — einen Web-Storage-Wert lesen
Storage.getItem(key) liest synchron Text aus localStorage oder sessionStorage. Gibt null zurück, wenn der Schlüssel nicht existiert; eine leere Zeichenfolge ist ein vorhandener Wert und kein fehlender Eintrag.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
storage.getItem(key)Storage.getItem ist eine Instanzmethode von Storage, die von localStorage und sessionStorage verwendet wird. Sie erwartet einen Schlüssel als Zeichenfolge und gibt den gespeicherten Text oder null zurück, wenn der Eintrag nicht existiert. Das Lesen erfolgt synchron und entfernt den Eintrag nicht.
Unterscheide zwischen null, "" und "null". Prüfe, ob ein Eintrag fehlt, mit value === null und nicht mit !value, denn das trifft auch auf eine leere Zeichenfolge zu. Gespeicherte Zahlen und Objekte erhalten ihre ursprünglichen Typen nicht automatisch zurück.
Dies ist eine Web-API, die im HTML Living Standard definiert ist, und keine Funktion einer bestimmten ECMAScript-Version. Sie wird von modernen Browsern weitgehend unterstützt; die Node-Version des Repositorys belegt keine Browserunterstützung. Schon der Zugriff auf window.localStorage oder window.sessionStorage kann wegen eines undurchsichtigen Ursprungs oder einer Browserrichtlinie einen SecurityError auslösen.
Das Beispiel unterscheidet eine leere Zeichenfolge, die Zeichenfolge "42" und einen fehlenden Eintrag. Es wählt einen unbenutzten Schlüssel und entfernt den temporären Eintrag, um zu prüfen, ob das Lesen null zurückgibt. Der finally-Block wiederholt den Löschvorgang, um auch bei einem Fehler aufzuräumen, ohne den gesamten Speicher zu leeren.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.getItem: empty and missing values</title>
</head>
<body>
<h1>Reading a storage value</h1>
<p id="source"></p>
<script>
function readValues(storage) {
let key = 'cktis:getItem';
while (storage.getItem(key) !== null) key += ':';
try {
storage.setItem(key, '');
const empty = storage.getItem(key);
storage.setItem(key, '42');
const text = storage.getItem(key);
storage.removeItem(key);
return [JSON.stringify(empty), JSON.stringify(text), storage.getItem(key) === null];
} finally {
storage.removeItem(key);
}
}
let lines;
let source = 'Using browser sessionStorage.';
try {
lines = readValues(window.sessionStorage);
} catch (error) {
if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
source = error.name === 'QuotaExceededError'
? 'Could not write the demo value to sessionStorage. Existing entries may still be readable. Using an in-memory fixture, not Web Storage.'
: 'Browser storage is unavailable. Using an in-memory fixture, not Web Storage.';
const entries = new Map();
lines = readValues({
getItem(key) { return entries.has(key) ? entries.get(key) : null; },
setItem(key, value) { entries.set(key, String(value)); },
removeItem(key) { entries.delete(key); }
});
}
document.getElementById('source').textContent = source;
for (const line of lines) console.log(line);
</script>
</body>
</html>Ergebnis
"" "42" true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.