CKTIS / JavaScript
Storage.clear() — odstránenie všetkých položiek
Storage.clear() synchrónne odstráni všetky dvojice kľúč – hodnota z vybranej oblasti Web Storage. Neprijíma žiadne argumenty a vracia undefined. Pozor: odstráni aj položky, ktoré nesúvisia s vaším kódom.
Verzia: 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 pracuje s objektom Storage: localStorage.clear() vymaže miestnu oblasť daného originu, zatiaľ čo sessionStorage.clear() vymaže oblasť relácie pre daný origin a kartu. Nevymaže obe oblasti naraz. Ide o API štandardu HTML, nie ECMAScriptu.
Metóda je synchrónna, neprijíma žiadne argumenty a vracia undefined. Prázdna oblasť zostane prázdna. Ak chcete odstrániť jednu položku, použite removeItem(key); clear() nefiltruje kľúče podľa predpony.
Odstránenie položiek zaradí udalosť storage do frontu pre ostatné oprávnené dokumenty, ktoré zdieľajú oblasť, nie však pre dokument, ktorý metódu zavolal. Jej polia key, oldValue a newValue majú hodnotu null. Prázdna oblasť nevyvolá žiadnu udalosť.
Prístup k window.localStorage alebo window.sessionStorage môže vyvolať SecurityError, napríklad pre politiku prehliadača. V príklade má iframe v dôsledku izolácie sandboxom nepriehľadný origin. Výraz typeof Storage.prototype.clear vráti "function", ale čítanie window.sessionStorage vyvolá SecurityError skôr, ako kód zavolá clear(). Žiadne položky sa neodstránia. Úspešné volanie sessionStorage.clear() skúšajte iba na samostatnej testovacej karte a na testovacom origine: vymaže všetky položky v úložisku relácie vrátane tých, ktoré tam už boli.
Príklady
<!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>Výsledok
typeof Storage.prototype.clear: function Clear not completed: SecurityError
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.