CKTIS / JavaScript
Storage.clear() — supprimer toutes les entrées
Storage.clear() supprime de façon synchrone toutes les paires clé-valeur de la zone Web Storage sélectionnée. La méthode ne prend aucun argument et renvoie undefined. Attention : elle supprime aussi les entrées sans rapport avec votre code.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
storage.clear()Storage.clear agit sur un objet Storage : localStorage.clear() vide la zone locale de l’origine concernée, tandis que sessionStorage.clear() vide la zone de session de cette origine et de cet onglet. La méthode ne vide pas les deux à la fois. Il s’agit d’une API de la norme HTML, et non d’ECMAScript.
La méthode est synchrone, ne prend aucun argument et renvoie undefined. Une zone vide le reste. Pour supprimer une seule entrée, utilisez removeItem(key) ; clear() ne filtre pas les clés par préfixe.
La suppression des entrées met en attente un événement storage pour les autres documents autorisés qui partagent la zone, mais pas pour le document appelant. Ses champs key, oldValue et newValue valent alors null. Une zone vide ne déclenche aucun événement.
L’accès à window.localStorage ou à window.sessionStorage peut déclencher une SecurityError, par exemple en raison de la politique du navigateur. Dans l’exemple, le bac à sable donne à l’iframe une origine opaque. typeof Storage.prototype.clear renvoie "function", mais la lecture de window.sessionStorage déclenche une SecurityError avant que le code n’appelle clear(). Aucune entrée n’est supprimée. Pour tester un appel réussi à sessionStorage.clear(), utilisez uniquement un onglet et une origine réservés aux essais : cet appel supprime toutes les entrées de la zone de stockage de session, y compris celles déjà présentes.
Exemples
<!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>Résultat
typeof Storage.prototype.clear: function Clear not completed: SecurityError
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.