CKTIS / JavaScript
Storage: Einträge zählen und Schlüsselnamen lesen
Storage stellt über localStorage und sessionStorage Zeichenfolgen als Schlüssel-Wert-Paare bereit. Erfahre den Unterschied zwischen Storage.length, das Einträge zählt, und Storage.key(index), das einen Schlüsselnamen statt seines Werts zurückgibt.
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.length
storage.key(index)
storage.getItem(key)
storage.setItem(key, value)
storage.removeItem(key)
storage.clear()Storage ist eine durch HTML definierte Web-API-Schnittstelle, nicht durch ECMAScript. Du erhältst ihre Objekte über window.localStorage oder window.sessionStorage. Ersteres ist für die Speicherung über die aktuelle Sitzung hinaus gedacht; Letzteres ist an die Sitzung und den Ursprung eines Tabs gebunden. Schlüssel und Werte sind Zeichenfolgen.
Storage.length ist schreibgeschützt: Die Eigenschaft gibt die Anzahl der Paare an, nicht ihre Größe in Bytes. Beim Aufruf von Storage.key(index) wandelt Web IDL das Argument zunächst in den Typ unsigned long um. Die Methode verwendet den umgewandelten Wert als nullbasierten Index und gibt einen Schlüsselnamen zurück oder null, wenn dieser Index mindestens length beträgt. Beispielsweise verwendet storage.key(2 ** 32) den Index 0 und gibt einen Schlüsselnamen zurück, wenn der Speicher nicht leer ist. Den Wert liest du mit getItem(key).
Die Reihenfolge der Schlüssel ist nicht festgelegt und kann sich bei Änderungen ändern. Setze keine Einfügereihenfolge voraus und entferne keine Einträge, während du anhand von Indizes iterierst. Sammle die Namen und sortiere sie, wenn du sie reproduzierbar darstellen möchtest.
Der Zugriff kann SecurityError auslösen, und beim Schreiben kann QuotaExceededError auftreten. Behandle diese Fehler in Anwendungen. Das Beispiel versucht zunächst, window.sessionStorage zu verwenden. Fängt es SecurityError oder QuotaExceededError ab, verwendet es statt Web Storage einen Testspeicher im Arbeitsspeicher und erzeugt dieselbe Konsolenausgabe. Dass Node 24 in einem Repository vorhanden ist, belegt keine Unterstützung dieser Web-API.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage: counting entries and reading key names</title>
</head>
<body>
<h1>Counting storage entries and listing their keys</h1>
<p id="source"></p>
<script>
function inspectStorage(storage) {
const names = ['cktis:storage:a', 'cktis:storage:b'].map(base => {
let name = base;
let suffix = 0;
while (storage.getItem(name) !== null) name = `${base}:${++suffix}`;
return name;
});
const written = [];
try {
const before = storage.length;
for (const [index, value] of ['10', '20'].entries()) {
storage.setItem(names[index], value);
written.push(names[index]);
}
const count = storage.length;
const keys = [];
for (let index = 0; index < count; index++) {
const name = storage.key(index);
if (names.includes(name)) keys.push(name);
}
return [count - before, keys.length, storage.key(count) === null];
} finally {
for (const name of written) storage.removeItem(name);
}
}
let lines;
let source = 'Using browser sessionStorage.';
try {
lines = inspectStorage(window.sessionStorage);
} catch (error) {
if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
source = 'The browser storage test write is unavailable. Using an in-memory fixture for this demonstration.';
const entries = new Map();
lines = inspectStorage({
get length() { return entries.size; },
key(index) { return Array.from(entries.keys())[index] ?? null; },
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
2 2 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.