Expires ou Max-Age
Sans l'un ni l'autre, c'est un cookie de session, effacé à la fermeture du navigateur. Avec, il persiste jusqu'à la date prévue.3
Informatique · Web
Cookies, localStorage, sessionStorage, IndexedDB, Cache API : cinq tiroirs, cinq usages, et quelques pièges.
Déjà à l'aise ? Aller au quizLe problème
Le navigateur n'est plus un simple lecteur de pages : il garde des données, parfois des gigaoctets1, et peut faire tourner une appli sans réseau.
Après cette fiche, tu sais
Je dirais que non, mais peut-être que si ?
Chaque site a son tiroir
Notion 1 · L'origine
Le navigateur range les données de chaque site dans un tiroir séparé. La clé de ce tiroir, c'est l'origine : le trio protocole, nom de domaine et port.7
Même origine ?
Compare chaque adresse avec https://mukbang.ch. Seule la première partage son tiroir.
Cinq technologies
Dans ce tiroir, cinq technologies cohabitent. Les chiffres exacts varient d'un navigateur à l'autre : retiens les ordres de grandeur.1
Fais défiler : les cinq stockages passent tour à tour, du plus petit au plus grand. Compare la capacité, ce qui survit, et ce qui part au serveur.
Cookies
Six adresses. Lesquelles partagent le stockage de https://mukbang.ch ?
Une clé, une valeur
Notion 2 · Web Storage
Deux objets, une même API. On range une valeur sous une clé, et tout est converti en chaîne de caractères9. Pour un objet, on passe donc par JSON dans les deux sens.
Partagé ou par onglet ?
localStorage est partagé par tous les onglets du site ; sessionStorage a son propre espace dans chaque onglet.2
Idéal pour une préférence (thème, langue, dernier niveau). Ouvrir le site dans un nouvel onglet démarre une session vide2 : idéal pour un formulaire en plusieurs étapes.
Écrire, lire, effacer
// écrire, lire, effacer une clé localStorage.setItem('theme', 'dark'); localStorage.getItem('theme'); // 'dark' ou null localStorage.removeItem('theme'); localStorage.clear(); // pour cette origine // un objet ? on le sérialise en JSON const panier = { articles: ['clavier'], total: 89 }; localStorage.setItem('panier', JSON.stringify(panier)); const relu = JSON.parse(localStorage.getItem('panier')) || { articles: [], total: 0 };
Piège
Deux limites à connaître. L'API est synchrone : chaque lecture bloque le fil principal, celui qui dessine la page. Le quota tourne autour de 5 Mo par origine : au-delà, setItem lève une exception QuotaExceededError, à attraper avec try/catch.1
Bonus utile
Quand un onglet modifie localStorage, les autres onglets du même site reçoivent l'événement storage, de quoi synchroniser un thème ou une déconnexion.2
Écouter les autres onglets
window.addEventListener('storage', (e) => { if (e.key === 'theme') { document.body.dataset.theme = e.newValue; } });
Une vraie base de données
Notion 3 · IndexedDB
IndexedDB stocke des objets JavaScript entiers (dates, tableaux, fichiers, images en Blob) dans des magasins d'objets (object stores), l'équivalent des tables. Chaque objet a une clé ; des index permettent de chercher vite sur d'autres champs.10
La transaction
Toute lecture ou écriture passe par une transaction. L'API est asynchrone : la page continue de s'afficher pendant que la base répond, même avec des milliers d'enregistrements.10
Le schéma évolue
Le schéma est versionné : pour ajouter un magasin ou un index, on ouvre la base avec un numéro de version plus grand. Le navigateur déclenche alors une mise à niveau (upgradeneeded).10
L'API native, verbeuse (1/2)
On ouvre la base, et on crée le magasin dans l'événement upgradeneeded.
const req = indexedDB.open('Demo', 1); req.onupgradeneeded = () => { req.result.createObjectStore('fiches', { keyPath: 'id', autoIncrement: true }); };
L'API native, verbeuse (2/2)
Une fois la base ouverte, on écrit dans une transaction.
req.onsuccess = () => {
const tx = req.result.transaction(
'fiches', 'readwrite');
tx.objectStore('fiches')
.add({ url: 'bdd-locales.html', score: 90 });
tx.oncomplete = () => console.log('enregistré');
};
La même chose avec Dexie.js
Dexie est un emballage d'IndexedDB : même stockage, même quota, mais un code bien plus court.11
const db = new Dexie('Demo'); // clé auto-incrémentée + deux index db.version(1).stores({ fiches: '++id, url, score' }); await db.fiches.add({ url: 'bdd-locales.html', score: 90 }); const bonnes = await db.fiches .where('score').above(80).toArray();
Dans Mukbang
Ta progression (fiches visitées, scores, badges) vit dans une base IndexedDB nommée MukbangDB, gérée par Dexie.js, et nulle part ailleurs : Mukbang n'envoie rien à un serveur.
Ouvre les outils de développement (onglet Application sous Chrome, Stockage sous Firefox) pour la voir.
Petits mais bavards
Notion 4 · Cookies
Un cookie pèse au maximum environ 4 Ko.15 Sa particularité : le navigateur le joint automatiquement à chaque requête HTTP vers son domaine.3
Qui pose le cookie
Le plus souvent, c'est le serveur qui le pose, avec un en-tête de réponse. Le navigateur le garde, puis le renvoie à chaque requête. C'est parfait pour reconnaître une session, mauvais pour stocker des données : ce qu'on y range voyage avec chaque image, chaque script et chaque appel d'API.
L'en-tête de réponse
Une seule ligne dans la réponse HTTP, coupée ici pour la lisibilité :
Set-Cookie: session=4f9a; Max-Age=3600; Path=/;
Secure; HttpOnly; SameSite=Lax
Pour les en-têtes HTTP en général, voir HTTP et les API REST.
Sans l'un ni l'autre, c'est un cookie de session, effacé à la fermeture du navigateur. Avec, il persiste jusqu'à la date prévue.3
Le cookie ne part que sur une connexion HTTPS.
Invisible pour JavaScript : document.cookie ne le voit pas, un script injecté ne peut donc pas le lire. Seul le serveur peut poser cet attribut.
Strict (jamais envoyé depuis un autre site), Lax (envoyé quand on arrive par un lien), None (toujours, et alors Secure est obligatoire). C'est la protection de base contre la falsification de requête inter-sites (CSRF).3
Parce qu'il repart avec chaque image et chaque script ?
Côté JavaScript
Une seule chaîne à la fois : document.cookie ajoute ou remplace un cookie, et renvoie tous ceux qui ne sont pas HttpOnly. Max-Age=31536000 fait 31 536 000 secondes, soit un an.3
// ajoute ou remplace UN seul cookie document.cookie = 'langue=fr; Max-Age=31536000; Path=/; SameSite=Lax'; // lit tous les cookies d'un bloc (jamais les HttpOnly) console.log(document.cookie); // 'langue=fr; autre=1'
Ça marche sans réseau
Notion 5 · Hors-ligne
La Cache API14 conserve des réponses HTTP complètes (une page, un fichier CSS, une image, un JSON), retrouvées grâce à leur requête.4 Avec un Service Worker, un script qui s'installe entre la page et le réseau, elle répond même sans réseau.
Installer (1/2)
À l'installation, le Service Worker range des fichiers dans un cache nommé v1.
self.addEventListener('install', (event) => { event.waitUntil( caches.open('v1').then((cache) => cache.addAll(['/', '/index.html', '/app.css'])) ); });
Répondre (2/2)
À chaque requête, on répond depuis le cache, ou depuis le réseau si l'entrée manque.
self.addEventListener('fetch', (event) => { event.respondWith( caches.match(event.request) .then((rep) => rep || fetch(event.request)) ); });
Rapide et disponible hors ligne. Pour les fichiers qui changent peu : logo, polices, CSS versionné.
Données fraîches si possible, copie du cache en secours. Pour un fil d'actualités.
On sert tout de suite la copie du cache, et on la met à jour en arrière-plan pour la visite suivante.
À savoir
Un Service Worker ne s'installe que sur une page servie en HTTPS (ou sur localhost pendant le développement).4
Cas 1 · Appli hors ligne (PWA)
C'est le cœur des PWA, les applications web installables. Le Service Worker et la Cache API gardent les fichiers de l'appli. IndexedDB garde les données (dernier fil chargé, brouillons). L'appli s'ouvre dans le métro, sans réseau.
Cas 2 · Jeu web
Sauvegarde, inventaire et textures vont dans IndexedDB, bien plus adapté que localStorage pour des objets et des fichiers. C'est ce que fait Mukbang pour tes XP et tes badges.
Cas 3 · Site avec connexion
Le SDK de Supabase, par exemple, enregistre la session de l'utilisateur dans localStorage quand l'option persistSession est active8. C'est simple, mais lisible par tout script injecté dans la page. Pour une application sensible, on préfère un cookie HttpOnly posé par un serveur.
Le stockage n'est pas une sauvegarde
Notion 6 · Quotas, éviction et Safari
Chaque origine reçoit un quota, partagé entre IndexedDB et la Cache API. Par défaut, ce stockage est « au mieux » (best effort) : si le disque se remplit, le navigateur efface d'abord les données des sites les moins récemment utilisés, site par site.1
Mesurer et protéger
Deux appels permettent de surveiller et de protéger ces données.12
const { usage, quota } = await navigator.storage.estimate(); console.log((usage / 1e6).toFixed(1) + ' Mo utilisés sur ' + (quota / 1e6).toFixed(0) + ' Mo'); // true si le navigateur accepte de ne plus évincer ce site const protege = await navigator.storage.persist();
Navigation privée et réglages
En navigation privée, tout fonctionne, mais tout est effacé à la fermeture de la fenêtre privée. Et l'utilisateur peut à tout moment vider les données d'un site depuis les réglages.
Le boss final
Depuis Safari 13.1 (2020), après 7 jours d'utilisation de Safari sans interaction avec un site, WebKit efface ce que les scripts de ce site ont écrit, par exemple localStorage, IndexedDB ou la Cache API.5 Une appli web ajoutée à l'écran d'accueil compte ses propres jours d'utilisation.
Fais défiler : chaque carte fait subir un événement au tiroir d'une appli web qui garde aussi une copie sur son serveur. Regarde quels compartiments se vident, et lesquels résistent.
Cookie de session, étape de formulaire (sessionStorage), thème (localStorage), progression (IndexedDB), et une copie sur le serveur.
Tout survit, même sessionStorage : il vit aussi longtemps que l'onglet, rechargements compris.
sessionStorage part avec l'onglet. Le cookie de session survit : le navigateur, lui, est toujours ouvert.
Le cookie de session disparaît, sauf si le navigateur restaure la session. localStorage et IndexedDB restent.
Continue de défiler : au septième jour d'usage sans visite, WebKit efface tout ce que les scripts du site ont écrit.
La progression revient depuis le serveur ; le thème, qui n'existait qu'en local, repart à sa valeur par défaut.
Rien n'est secret ici
Notion 7 · Sécurité
Tout ce que ton JavaScript peut lire, un script malveillant injecté dans ta page (faille XSS) peut le lire aussi, puis l'envoyer ailleurs. Et l'utilisateur, lui, voit et modifie tout depuis les outils de développement.6
Ni mot de passe, ni clé d'API secrète, ni numéro de carte dans localStorage, sessionStorage, IndexedDB ou un cookie lisible par JavaScript.
Un jeton de session sensible va de préférence dans un cookie HttpOnly, Secure et SameSite, posé par le serveur.
Un estAdmin: true dans localStorage se modifie en deux clics : les droits se vérifient côté serveur.
Une valeur piégée comme <img src=x onerror="…"> s'exécuterait avec innerHTML.13
Réafficher sans risque
Réaffiche une valeur stockée avec textContent : elle reste du texte.
const pseudo = localStorage.getItem('pseudo'); // dangereux : le HTML piégé s'exécute el.innerHTML = pseudo; // sûr : affiché comme du simple texte el.textContent = pseudo;
Huit besoins réels, cinq stockages. Choisis le plus adapté à chaque fois.
Ce simulateur écrit dans le vrai localStorage de ce site. Chaque clé est préfixée bunker: pour ne jamais toucher aux autres données de Mukbang, qui vivent dans le même tiroir (préférences, petits jeux) : préfixer ses clés est d'ailleurs une bonne pratique.
Pièges fréquents
Six pièges reviennent presque partout. Fais défiler pour les voir un à un.
JSON.stringifylocalStorage enregistre alors la chaîne "[object Object]", et les données sont perdues.
Une clé absente donne null : prévois une valeur par défaut (|| {}) avant d'accéder à ses champs.
Chaque onglet a le sien : deux onglets ouverts sur le même site ne se voient pas.
L'API est synchrone : l'interface gèle. Au-delà de quelques Ko structurés, passe à IndexedDB.
Il suffit d'une faille XSS pour qu'il parte ailleurs.
Éviction, navigation privée, nettoyage par l'utilisateur, purge de Safari : garde une copie serveur de ce qui compte.
Cherche d'abord, seul
Entraînement
Cherche d'abord seul, puis ouvre le corrigé.
undefined. Explique pourquoi et corrige-le.Voir le corrigélocalStorage.setItem('user', { nom: 'Léa' });
const u = localStorage.getItem('user');
console.log(u.nom); // undefined
localStorage ne stocke que des chaînes : l'objet est converti en "[object Object]". getItem renvoie donc cette chaîne, qui n'a pas de propriété nom. Il faut sérialiser à l'écriture et désérialiser à la lecture :
localStorage.setItem('user', JSON.stringify({ nom: 'Léa' }));
const u = JSON.parse(localStorage.getItem('user')) || {};
console.log(u.nom); // 'Léa'visites après (a) le premier chargement ; (b) un rechargement ; (c) l'ouverture du site dans un deuxième onglet ; (d) la fermeture de tous les onglets puis une nouvelle visite ? Et avec localStorage ?Voir le corrigéconst avant = sessionStorage.getItem('visites');
const n = Number(avant || 0) + 1;
sessionStorage.setItem('visites', n);
Avec sessionStorage : (a) 1 ; (b) 2, car le rechargement garde la session ; (c) 1 dans le deuxième onglet, qui démarre sa propre session (le premier garde 2) ; (d) 1, car une nouvelle session démarre. Avec localStorage : 1, 2, 3 puis 4 : la valeur est partagée et persiste après la fermeture.
(a) localStorage : une petite chaîne, persistante, lue au démarrage. (b) sessionStorage : survit au rechargement, disparaît avec l'onglet, et deux onglets ne se mélangent pas. (c) Cache API pour les fichiers (via un Service Worker) et IndexedDB pour les données, avec navigator.storage.persist(). (d) Cookie HttpOnly, Secure, SameSite posé par le serveur : aucun script de la page ne peut le lire. (e) IndexedDB avec un index sur le score : tri et recherche rapides, sans bloquer l'interface.
sauver(cle, valeur) qui enregistre n'importe quel objet dans localStorage, renvoie true si tout va bien et false si l'écriture échoue, sans jamais faire planter la page.Voir le corrigéfunction sauver(cle, valeur) {
try {
localStorage.setItem(cle, JSON.stringify(valeur));
return true;
} catch (e) {
// QuotaExceededError : quota plein
// SecurityError : stockage bloqué
console.warn('Sauvegarde impossible :', e.name);
return false;
}
}
Le try/catch entoure aussi JSON.stringify, qui peut échouer sur un objet circulaire. Pour de gros volumes, la vraie réponse reste IndexedDB.
À retenir (1/2)
À retenir (2/2)
storage.estimate() et storage.persist().textContent et non innerHTML.Douze questions pour finir
auth.persistSession), consulté le 8 octobre 2026. supabase.comestimate() et persist()), consulté le 8 octobre 2026. developer.mozilla.orgFiche relue et sourcée en septembre 2026, refaite en récit en octobre 2026.