CKTIS / JavaScript
sessionStorage — archiviazione della sessione della scheda
sessionStorage memorizza coppie chiave-valore sotto forma di stringhe per un’origine e una sessione della scheda. È adatto a stati temporanei, come una bozza di modulo, ma l’accesso all’archiviazione o la scrittura possono non riuscire.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
window.sessionStorage
sessionStorage.setItem(key, value)
sessionStorage.getItem(key)
sessionStorage.removeItem(key)
sessionStorage.clear()window.sessionStorage restituisce un oggetto Storage associato a un’origine e a una sessione della scheda. I dati restano disponibili dopo il ricaricamento della pagina. A differenza di localStorage, non è pensato per mantenere uno stato tra sessioni diverse. Le schede separate hanno archivi distinti; una nuova finestra ausiliaria può ricevere inizialmente una copia dei dati della finestra che l’ha aperta, ma le modifiche successive sono indipendenti.
Le operazioni sono sincrone. setItem(key, value) memorizza testo, getItem(key) restituisce testo o null e removeItem(key) elimina una voce. clear() elimina tutte le voci di quell’archivio, non solo i dati di un componente: usalo con cautela.
L’accesso a sessionStorage può generare SecurityError, ad esempio a causa di una policy del browser o di un’origine opaca. La scrittura può generare QuotaExceededError. Gestisci le eccezioni e non considerare l’archiviazione come l’unica copia di dati importanti né come un luogo per segreti accessibili a un solo script.
Questa è una Web API definita in HTML, non una funzionalità di una particolare edizione di ECMAScript. Lo standard indica il supporto in tutti i motori dei browser attuali; la presenza di Node 24 in un repository non dimostra il supporto di questa API del browser.
Esempi
<!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>Risultato
Session storage unavailable: SecurityError
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.