CKTIS / JavaScript
sessionStorage — stockage de session de l’onglet
sessionStorage stocke des paires clé-valeur sous forme de chaînes pour une origine et une session d’onglet. Il convient à un état temporaire, comme le brouillon d’un formulaire, mais l’accès au stockage ou l’écriture peut échouer.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
window.sessionStorage
sessionStorage.setItem(key, value)
sessionStorage.getItem(key)
sessionStorage.removeItem(key)
sessionStorage.clear()window.sessionStorage renvoie un objet Storage associé à une origine et à une session d’onglet. Les données survivent au rechargement de la page. Contrairement à localStorage, il n’est pas destiné à conserver un état entre plusieurs sessions. Les onglets distincts ont des stockages distincts ; une nouvelle fenêtre auxiliaire peut d’abord recevoir une copie des données de la fenêtre qui l’a ouverte, mais les modifications ultérieures sont indépendantes.
Les opérations sont synchrones. setItem(key, value) stocke du texte, getItem(key) renvoie du texte ou null, et removeItem(key) supprime une entrée. clear() supprime toutes les entrées de ce stockage, pas seulement les données d’un composant — utilisez-le avec prudence.
L’accès à sessionStorage peut déclencher une SecurityError, par exemple en raison d’une règle du navigateur ou d’une origine opaque. Une écriture peut déclencher une QuotaExceededError. Gérez les exceptions et ne considérez pas le stockage comme l’unique copie de données importantes ni comme un emplacement pour des secrets auxquels un seul script devrait avoir accès.
Il s’agit d’une API Web définie dans HTML, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. Le standard indique qu’elle est prise en charge par tous les moteurs de navigateur actuels ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge de cette API de navigateur.
Exemples
<!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>Résultat
Session storage unavailable: SecurityError
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.