CKTIS / JavaScript
Storage.clear() — премахване на всички записи
Storage.clear() синхронно премахва всички двойки ключ–стойност от избраната област на Web Storage. Не приема аргументи и връща 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.clear()Storage.clear работи с обект Storage: localStorage.clear() изчиства локалната област на съответния origin, а sessionStorage.clear() изчиства областта за сесията на този origin и раздел. Методът не изчиства и двете едновременно. Това е API на стандарта HTML, а не на ECMAScript.
Методът е синхронен, не приема аргументи и връща undefined. Празната област остава празна. За да премахнете един запис, използвайте removeItem(key); clear() не филтрира ключовете по префикс.
Премахването на записи поставя събитие storage на опашка за други допустими документи, които споделят областта, но не и за документа, извикал метода. Полетата key, oldValue и newValue имат стойност null. Празната област не поражда събитие.
Достъпът до window.localStorage или window.sessionStorage може да доведе до SecurityError, например заради правилата на браузъра. В примера iframe има непрозрачен origin заради изолацията чрез sandbox. Изразът typeof Storage.prototype.clear връща "function", но прочитането на window.sessionStorage предизвиква SecurityError, преди кодът да извика clear(). Не се изтриват записи. Изпробвайте успешно извикване на sessionStorage.clear() само в отделен тестов раздел и на тестов origin: то изтрива всички записи от областта за съхранение на сесията, включително вече съществуващите.
Примери
<!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>Резултат
typeof Storage.prototype.clear: function Clear not completed: SecurityError
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.