CKTIS / JavaScript
Storage.removeItem — supprimer une entrée
La méthode removeItem(key) supprime une paire clé-valeur précise de localStorage ou sessionStorage. Elle renvoie undefined ; l’absence de la clé ne provoque pas d’erreur.
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.removeItem(key)Storage.removeItem est une méthode synchrone de Web Storage, définie par le HTML Standard et non par ECMAScript. Appelez-la sur localStorage ou sessionStorage en passant la clé sous forme de chaîne. Tous les principaux moteurs de navigateur prennent en charge cette méthode, mais certains moteurs n’implémentent pas Web Storage. La présence de Node 24 dans un dépôt ne prouve pas sa prise en charge par les navigateurs.
removeItem(key) supprime uniquement l’entrée indiquée et renvoie undefined, même si la clé n’existe pas. Après la suppression, getItem(key) renvoie null. En revanche, clear() supprime toutes les entrées de l’espace de stockage sélectionné.
Une suppression effective place un événement storage dans la file d’attente pour les autres documents qui partagent l’espace de stockage, mais pas pour la fenêtre qui effectue l’opération ; newValue vaut null. Une clé absente ne déclenche aucun événement.
L’accès à window.localStorage ou window.sessionStorage peut lever une exception SecurityError, par exemple en raison d’une règle du navigateur. L’exemple essaie d’abord d’utiliser window.sessionStorage. Si cette tentative lève une exception SecurityError ou QuotaExceededError, il utilise un objet de test qui conserve les données en mémoire dans une Map, et non dans Web Storage. Dans les deux cas, l’exemple choisit une clé inutilisée, y associe une entrée temporaire, puis supprime cette entrée.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Storage.removeItem: removing one entry</title>
</head>
<body>
<h1>Removing a storage entry</h1>
<p id="source"></p>
<script>
function checkRemoval(storage) {
let key = 'cktis:removeItem';
while (storage.getItem(key) !== null) key += ':';
try {
storage.setItem(key, 'draft');
const removed = storage.removeItem(key);
const missing = storage.getItem(key) === null;
const removedAgain = storage.removeItem(key);
return [removed === undefined, missing, removedAgain === undefined && storage.getItem(key) === null];
} finally {
storage.removeItem(key);
}
}
let lines;
let source = 'Using browser sessionStorage.';
try {
lines = checkRemoval(window.sessionStorage);
} catch (error) {
if (error.name !== 'SecurityError' && error.name !== 'QuotaExceededError') throw error;
source = 'Could not access browser sessionStorage or write the test entry. Using an in-memory fixture, not Web Storage.';
const entries = new Map();
lines = checkRemoval({
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>Résultat
true true true
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.