CKTIS / JavaScript
localStorage — stockage local des données
localStorage met à disposition du navigateur un espace de stockage de paires clé-valeur sous forme de chaînes, associé à une origine. Les données peuvent persister au-delà d’une session, mais l’accès et la persistance dépendent des règles du navigateur.
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.localStorage
localStorage.setItem(key, value)
localStorage.getItem(key)
localStorage.removeItem(key)window.localStorage renvoie un objet Storage pour l’origine de la page. Il s’agit d’une API Web définie par le HTML Living Standard, et non d’une fonctionnalité ECMAScript. Les moteurs de navigateur actuels la prennent en charge ; Node 24 dans le dépôt ne permet pas d’établir la prise en charge par les navigateurs.
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 cet espace de stockage, et pas seulement celles de l’application.
Contrairement à sessionStorage, les données peuvent persister au-delà d’une session et être partagées entre des fenêtres de même origine. Ce n’est pas une sauvegarde : l’utilisateur ou le navigateur peut les supprimer. Ne supposez pas qu’un verrou protège les opérations de lecture–modification–écriture. Les changements déclenchent un événement storage dans les autres fenêtres utilisant cet espace de stockage, mais pas dans la fenêtre qui écrit.
L’accès lui-même peut déclencher SecurityError, et l’écriture peut déclencher QuotaExceededError ; gérez ces deux erreurs. Les scripts de même origine peuvent lire les données : n’y stockez donc pas de secrets. Si les opérations réussissent, l’exemple écrit une valeur sous une clé générée aléatoirement, la relit, puis supprime l’entrée sans rétablir de valeur antérieure. Lors de l’exécution présentée, l’accès à window.localStorage déclenche une erreur SecurityError avant que le code n’atteigne l’étape d’écriture.
Exemples
(() => {
const key = `cktis-storage-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
try {
const storage = window.localStorage;
storage.setItem(key, 42);
let stored;
try {
stored = storage.getItem(key);
} finally {
storage.removeItem(key);
}
console.log(`Stored as a string: ${stored === '42'}`);
console.log(`Missing after removal: ${storage.getItem(key) === null}`);
} catch (error) {
console.log(`Storage unavailable: ${error.name}`);
}
})();Résultat
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.