CKTIS / JavaScript
Storage.clear() — alle Einträge entfernen
Storage.clear() entfernt synchron alle Schlüssel-Wert-Paare aus dem ausgewählten Web-Storage-Bereich. Die Methode benötigt keine Argumente und gibt undefined zurück. Vorsicht: Sie löscht auch Einträge, die nicht zu deinem Code gehören.
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.clear()Storage.clear arbeitet mit einem Storage-Objekt: localStorage.clear() leert den lokalen Bereich des jeweiligen Origin, während sessionStorage.clear() den Sitzungsbereich dieses Origin und Tabs leert. Die Methode leert nicht beide zugleich. Dies ist eine API des HTML-Standards, nicht von ECMAScript.
Die Methode ist synchron, benötigt keine Argumente und gibt undefined zurück. Ein leerer Bereich bleibt leer. Um einen einzelnen Eintrag zu löschen, verwende removeItem(key); clear() filtert Schlüssel nicht nach Präfix.
Das Entfernen von Einträgen reiht ein storage-Ereignis für andere berechtigte Dokumente ein, die den Bereich gemeinsam nutzen, nicht aber für das aufrufende Dokument. Die Felder key, oldValue und newValue sind dabei null. Bei einem leeren Bereich wird kein Ereignis ausgelöst.
Der Zugriff auf window.localStorage oder window.sessionStorage kann einen SecurityError auslösen, zum Beispiel aufgrund der Browserrichtlinien. Im Beispiel hat der iframe durch die Sandbox einen opaken Origin. typeof Storage.prototype.clear gibt "function" zurück, aber schon das Lesen von window.sessionStorage löst einen SecurityError aus, bevor der Code clear() aufruft. Es werden keine Einträge gelöscht. Teste einen erfolgreichen Aufruf von sessionStorage.clear() nur in einem separaten Test-Tab und auf einem Test-Origin: Er löscht alle Einträge im Sitzungsbereich, auch bereits vorhandene.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.clear() and storage access</title>
</head>
<body>
<script>
const frame = document.createElement('iframe');
frame.title = 'Isolated Storage.clear test';
frame.setAttribute('sandbox', 'allow-scripts');
frame.srcdoc = `<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Storage clear test</title></head>
<body>
<p role="status"></p>
<script>
const methodType = typeof Storage.prototype.clear;
const methodStatus = 'typeof Storage.prototype.clear: ' + methodType;
let resultStatus;
try {
const storage = window.sessionStorage;
storage.setItem('demo:color', 'blue');
storage.setItem('demo:count', '2');
const result = storage.clear();
resultStatus = 'Remaining entries: ' + storage.length + '; return value: ' + String(result);
} catch (error) {
resultStatus = 'Clear not completed: ' + error.name;
}
document.querySelector('[role="status"]').textContent = methodStatus + '. ' + resultStatus;
console.log(methodStatus);
console.log(resultStatus);
<\/script>
</body>
</html>`;
document.body.append(frame);
</script>
</body>
</html>Ergebnis
typeof Storage.prototype.clear: function Clear not completed: SecurityError
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.