CKTIS / JavaScript
Storage.removeItem — премахване на един запис
Методът removeItem(key) премахва конкретна двойка ключ-стойност от localStorage или sessionStorage. Връща undefined; липсващ ключ не предизвиква грешка.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
storage.removeItem(key)Storage.removeItem е синхронен метод на Web Storage, дефиниран в HTML Standard, а не в ECMAScript. Извикайте го върху localStorage или sessionStorage, като подадете ключа като низ. Всички основни браузърни енджини поддържат метода, но не всеки браузърен енджин поддържа Web Storage. Наличието на Node 24 в хранилище не доказва поддръжка в браузърите.
removeItem(key) премахва само посочения запис и връща undefined, дори ако ключът не съществува. След премахването getItem(key) връща null. За разлика от него, clear() премахва всички записи от избраното хранилище.
При действително премахване се поставя в опашката събитие storage за другите документи, които споделят хранилището, но не и за прозореца, извършващ операцията; newValue е null. Липсващ ключ не поражда събитие.
Достъпът до window.localStorage или window.sessionStorage може да доведе до изключение SecurityError, например заради правила на браузъра. Примерът първо се опитва да използва window.sessionStorage. Ако при опита възникне изключение SecurityError или QuotaExceededError, вместо Web Storage използва тестов обект, който съхранява данните в паметта чрез Map. И в двата случая примерът избира неизползван ключ, създава временен запис с този ключ и след това премахва записа.
Примери
<!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>Резултат
true true true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.