CKTIS / JavaScript
sessionStorage — magazyn sesji karty
sessionStorage przechowuje pary tekstowych kluczy i wartości dla danego originu oraz sesji karty. Nadaje się do tymczasowego stanu, np. szkicu formularza, ale dostęp i zapis mogą się nie powieść.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
window.sessionStorage
sessionStorage.setItem(key, value)
sessionStorage.getItem(key)
sessionStorage.removeItem(key)
sessionStorage.clear()window.sessionStorage zwraca obiekt Storage powiązany z originem i sesją karty. Dane przetrwają przeładowanie strony. W przeciwieństwie do localStorage nie służą do przechowywania stanu między sesjami. Osobne karty mają osobne magazyny; nowe okno pomocnicze może początkowo otrzymać kopię danych okna otwierającego, ale późniejsze zmiany są niezależne.
Operacje są synchroniczne. setItem(key, value) zapisuje tekst, getItem(key) zwraca tekst albo null, a removeItem(key) usuwa wpis. clear() usuwa wszystkie wpisy w tym magazynie, nie tylko dane jednego komponentu — używaj go ostrożnie.
Odczyt sessionStorage może zgłosić SecurityError, np. z powodu polityki przeglądarki lub nieprzezroczystego originu. Zapis może zgłosić QuotaExceededError. Obsługuj wyjątki i nie traktuj magazynu jako jedynej kopii ważnych danych ani miejsca na sekrety dostępne tylko dla jednego skryptu.
To Web API zdefiniowane w HTML, nie funkcja konkretnej edycji ECMAScript. Standard wskazuje obsługę we wszystkich obecnych silnikach przeglądarek; obecność Node 24 w repozytorium nie potwierdza działania tego API przeglądarkowego.
Przykłady
<!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>Wynik
Session storage unavailable: SecurityError
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.