CKTIS / JavaScript
Storage.removeItem — één item verwijderen
De methode removeItem(key) verwijdert een specifiek sleutel-waardepaar uit localStorage of sessionStorage. De methode retourneert undefined; een ontbrekende sleutel veroorzaakt geen fout.
Versie: 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.removeItem(key)Storage.removeItem is een synchrone Web Storage-methode die is gedefinieerd in de HTML Standard, niet in ECMAScript. Roep de methode aan op localStorage of sessionStorage en geef de sleutel als tekenreeks door. Alle gangbare browser-engines ondersteunen de methode, maar niet elke browser-engine implementeert Web Storage. De aanwezigheid van Node 24 in een repository bewijst geen browserondersteuning.
removeItem(key) verwijdert alleen het opgegeven item en retourneert undefined, ook als de sleutel niet bestaat. Na verwijdering retourneert getItem(key) null. clear() verwijdert daarentegen alle items uit het geselecteerde opslaggebied.
Bij een daadwerkelijke verwijdering wordt een storage-gebeurtenis in de wachtrij geplaatst voor andere documenten die hetzelfde opslaggebied delen, maar niet voor het venster dat de bewerking uitvoert; newValue is null. Een ontbrekende sleutel veroorzaakt geen gebeurtenis.
Toegang tot window.localStorage of window.sessionStorage kan een SecurityError veroorzaken, bijvoorbeeld door browserbeleid. Het voorbeeld probeert eerst window.sessionStorage te gebruiken. Leidt die poging tot een SecurityError of QuotaExceededError, dan gebruikt het in plaats van Web Storage een testobject dat de gegevens in een Map in het geheugen bewaart. In beide gevallen kiest het voorbeeld een ongebruikte sleutel, slaat het onder die sleutel een tijdelijk item op en verwijdert het dat item vervolgens.
Voorbeelden
<!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>Resultaat
true true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.