CKTIS / JavaScript
Storage.removeItem — odstranění jedné položky
Metoda removeItem(key) odstraní konkrétní dvojici klíče a hodnoty z localStorage nebo sessionStorage. Vrací undefined; chybějící klíč nezpůsobí chybu.
Verze: 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 je synchronní metoda Web Storage definovaná v HTML Standard, nikoli v ECMAScriptu. Volejte ji na localStorage nebo sessionStorage a předejte klíč jako řetězec. Podporují ji všechna hlavní jádra prohlížečů, ale ne každé jádro implementuje Web Storage. Přítomnost Node 24 v repozitáři nedokládá podporu v prohlížečích.
removeItem(key) odstraní pouze určenou položku a vrátí undefined, i když klíč neexistuje. Po odstranění vrací getItem(key) hodnotu null. Naproti tomu clear() odstraní všechny položky z vybraného úložiště.
Při skutečném odstranění se zařadí událost storage pro ostatní dokumenty sdílející dané úložiště, nikoli pro okno, které operaci provádí; newValue má hodnotu null. Chybějící klíč žádnou událost nevyvolá.
Přístup k window.localStorage nebo window.sessionStorage může vyvolat výjimku SecurityError, například kvůli zásadám prohlížeče. Příklad se nejprve pokusí použít window.sessionStorage. Pokud tento pokus vyvolá výjimku SecurityError nebo QuotaExceededError, použije místo Web Storage testovací objekt, který uchovává data v paměti pomocí Map. V obou případech příklad vybere nepoužitý klíč, uloží pod něj dočasnou položku a poté ji odstraní.
Příklady
<!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>Výsledek
true true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.