CKTIS / JavaScript
sessionStorage — хранилище за сесията на раздела
sessionStorage съхранява текстови двойки ключ–стойност за даден origin и сесия на раздел. Подходящо е за временно състояние, например чернова на формуляр, но достъпът до хранилището или записът може да се провалят.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
window.sessionStorage
sessionStorage.setItem(key, value)
sessionStorage.getItem(key)
sessionStorage.removeItem(key)
sessionStorage.clear()window.sessionStorage връща обект Storage, свързан с origin и сесия на раздел. Данните се запазват при презареждане на страницата. За разлика от localStorage, то не е предназначено за състояние, което се запазва между сесии. Отделните раздели имат отделни хранилища; нов помощен прозорец първоначално може да получи копие на данните от прозореца, който го е отворил, но последващите промени са независими.
Операциите са синхронни. setItem(key, value) съхранява текст, getItem(key) връща текст или null, а removeItem(key) премахва запис. clear() премахва всички записи в това хранилище, а не само данните на един компонент — използвайте го внимателно.
Достъпът до sessionStorage може да предизвика SecurityError, например заради политика на браузъра или непрозрачен origin. Записът може да предизвика QuotaExceededError. Обработвайте изключенията и не приемайте хранилището за единствено копие на важни данни или за място за тайни, достъпни само за един скрипт.
Това е Web API, дефиниран в HTML, а не функция на конкретно издание на ECMAScript. Стандартът посочва поддръжка във всички съвременни браузърни енджини; наличието на Node 24 в хранилище не доказва поддръжка на този API на браузъра.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Session storage access and draft values</title>
</head>
<body>
<script>
const frame = document.createElement('iframe');
frame.title = 'Session storage test';
frame.setAttribute('sandbox', 'allow-scripts');
frame.srcdoc = `<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Draft storage</title></head>
<body>
<p role="status"></p>
<script>
let message;
try {
const storage = window.sessionStorage;
const key = 'cktis:sessionStorage:draft';
const previous = storage.getItem(key);
try {
storage.setItem(key, 'draft');
const saved = storage.getItem(key);
storage.removeItem(key);
message = 'Saved: ' + saved + '; removed: ' + (storage.getItem(key) === null);
} finally {
if (previous === null) storage.removeItem(key);
else storage.setItem(key, previous);
}
} catch (error) {
message = 'Session storage unavailable: ' + error.name;
}
document.querySelector('[role="status"]').textContent = message;
console.log(message);
<\/script>
</body>
</html>`;
document.body.append(frame);
</script>
</body>
</html>Резултат
Session storage unavailable: SecurityError
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.