CKTIS / JavaScript
Stockage du navigateur
Le stockage du navigateur regroupe des mécanismes de l’environnement du navigateur permettant de conserver des données côté client. Découvrez la différence entre localStorage et sessionStorage, ainsi que la frontière entre le langage ECMAScript et les API Web.
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
localStorage.setItem(key, value);
localStorage.getItem(key);
localStorage.removeItem(key);Le stockage du navigateur (browser storage) est une fonctionnalité de l’environnement, et non une syntaxe ECMAScript. La spécification ECMAScript décrit le langage et son interaction avec son environnement hôte ; elle ne définit ni localStorage ni sessionStorage. La présence de Node 24 dans un dépôt ne prouve pas que ces interfaces sont disponibles dans le navigateur ciblé.
localStorage conserve des paires clé-valeur d’une session à l’autre, tandis que sessionStorage est lié à la session d’une page dans un onglet donné. Les deux interfaces sont synchrones et stockent des chaînes de caractères. getItem(key) renvoie null lorsque la clé est absente. Les objets peuvent être enregistrés avec JSON.stringify et lus avec JSON.parse.
L’accès dépend de l’origine de la page et des règles du navigateur. Les données peuvent être supprimées, et les accès ou écritures peuvent déclencher une exception. Ne considérez pas ce stockage comme l’unique copie de vos données ni comme un endroit où conserver des secrets. La section Web Storage de la norme HTML du WHATWG définit localStorage et sessionStorage ainsi que leurs méthodes. Elle ne constitue pas une référence sur la compatibilité avec les navigateurs et ne garantit pas que ces interfaces soient disponibles dans le navigateur ciblé.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Browser storage example</title>
</head>
<body>
<p>localStorage can persist across visits. sessionStorage is scoped to the page session in a tab. Both are browser APIs, not part of ECMAScript.</p>
<ul aria-label="Storage check results">
<li id="localStorage"></li>
<li id="sessionStorage"></li>
</ul>
<script>
const fixture = JSON.stringify({ theme: 'dark' });
function checkStorage(name) {
const result = document.getElementById(name);
try {
const store = window[name];
// A fresh temporary key avoids reusing application keys. This sequence is not atomic:
// another same-origin tab can change localStorage between calls.
const key = `cktis:storage:example:${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
if (store.getItem(key) !== null) {
throw new Error('Temporary storage key already exists');
}
store.setItem(key, fixture);
let saved;
try {
saved = store.getItem(key);
} finally {
store.removeItem(key);
}
if (saved !== fixture || store.getItem(key) !== null) {
throw new Error('Round trip or cleanup failed');
}
result.textContent = `${name}: read back theme=${JSON.parse(saved).theme}; temporary key removed.`;
} catch (error) {
if (!(error instanceof DOMException) || !['SecurityError', 'QuotaExceededError'].includes(error.name)) {
throw error;
}
result.textContent = `${name}: temporary write unavailable (${error.name}).`;
}
console.log(result.textContent);
}
checkStorage('localStorage');
checkStorage('sessionStorage');
</script>
</body>
</html>Résultat
A successful check reports that it read back theme=dark and removed the temporary key. If the check catches a DOMException named SecurityError or QuotaExceededError, it reports that the temporary write is unavailable and includes the error name. Other errors, including a temporary-key collision or a detected round-trip or cleanup failure, are rethrown without a report for that storage area. If the localStorage check rethrows, the sessionStorage check does not run.
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.