CKTIS / JavaScript
sessionStorage — úložisko relácie karty
sessionStorage ukladá reťazce v pároch kľúč – hodnota pre origin a reláciu karty. Hodí sa na dočasný stav, napríklad rozpísaný formulár, ale prístup k úložisku alebo zápis môžu zlyhať.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
window.sessionStorage
sessionStorage.setItem(key, value)
sessionStorage.getItem(key)
sessionStorage.removeItem(key)
sessionStorage.clear()window.sessionStorage vracia objekt Storage priradený k originu a relácii karty. Údaje zostávajú zachované aj po opätovnom načítaní stránky. Na rozdiel od localStorage nie je určené na uchovávanie stavu medzi reláciami. Samostatné karty majú samostatné úložiská; nové pomocné okno môže spočiatku dostať kópiu údajov okna, ktoré ho otvorilo, neskoršie zmeny sú však nezávislé.
Operácie sú synchrónne. setItem(key, value) uloží text, getItem(key) vráti text alebo null a removeItem(key) odstráni položku. clear() odstráni všetky položky v danom úložisku, nielen údaje jednej komponenty — používajte ho opatrne.
Prístup k sessionStorage môže vyvolať SecurityError, napríklad pre pravidlá prehliadača alebo nepriehľadný origin. Zápis môže vyvolať QuotaExceededError. Ošetrujte výnimky a nepovažujte úložisko za jedinú kópiu dôležitých údajov ani za miesto pre tajomstvá, ku ktorým má mať prístup iba jeden skript.
Ide o webové API definované v HTML, nie o funkciu konkrétneho vydania ECMAScriptu. Štandard uvádza podporu vo všetkých súčasných prehliadačových enginoch; prítomnosť Node 24 v repozitári nedokazuje podporu tohto API prehliadača.
Príklady
<!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>Výsledok
Session storage unavailable: SecurityError
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.