CKTIS / JavaScript
Storage.clear() — rimozione di tutte le voci
Storage.clear() rimuove in modo sincrono tutte le coppie chiave-valore dall’area Web Storage selezionata. Non accetta argomenti e restituisce undefined. Attenzione: elimina anche le voci non correlate al tuo codice.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
storage.clear()Storage.clear opera su un oggetto Storage: localStorage.clear() svuota l’area locale dell’origine corrispondente, mentre sessionStorage.clear() svuota l’area di sessione di quell’origine e scheda. Non svuota entrambe contemporaneamente. È un’API dello standard HTML, non di ECMAScript.
Il metodo è sincrono, non accetta argomenti e restituisce undefined. Se l’area è vuota, rimane vuota. Per eliminare una singola voce, usa removeItem(key); clear() non filtra le chiavi in base al prefisso.
La rimozione delle voci accoda un evento storage per gli altri documenti autorizzati che condividono l’area, ma non per il documento chiamante. I campi key, oldValue e newValue dell’evento valgono null. Un’area vuota non genera alcun evento.
L’accesso a window.localStorage o window.sessionStorage può generare una SecurityError, ad esempio a causa dei criteri del browser. Nell’esempio, la sandbox assegna all’iframe un’origine opaca. typeof Storage.prototype.clear restituisce "function", ma la lettura di window.sessionStorage genera una SecurityError prima che il codice chiami clear(). Non viene eliminata alcuna voce. Per provare una chiamata a sessionStorage.clear() che vada a buon fine, usa solo una scheda e un’origine riservate ai test: la chiamata elimina tutte le voci dell’area di archiviazione della sessione, comprese quelle già presenti.
Esempi
<!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>Risultato
typeof Storage.prototype.clear: function Clear not completed: SecurityError
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.