Cache du navigateur : fonctionnement, en-têtes et purge
Le cache du navigateur est la copie locale des réponses HTTP déjà reçues : fichiers JS, CSS, images, parfois le HTML lui-même. Ce sont les en-têtes `Cache-Control` et `ETag` renvoyés par le serveur qui fixent sa durée de vie, pas un réglage côté navigateur.
Ce que le navigateur garde, et où
Quand vous rechargez une page, le navigateur ne redemande pas tout. Il tient deux réserves séparées : un cache mémoire, perdu à la fermeture de l'onglet, et un cache disque qui survit au redémarrage de la machine. Dans l'onglet Network de Chrome, la colonne Size affiche alors `(memory cache)` ou `(disk cache)` au lieu d'un poids en kilo-octets, et la ligne reste en 200. Aucune requête n'est partie sur le réseau, donc il n'y a aucun 304 à voir.
Une entrée n'est pas identifiée par la seule URL.
Chrome 86 (octobre 2020) a intégré le site de premier niveau à la clé de cache : un `jquery.min.js` qu'un CDN public sert et qui a déjà été téléchargé sur un autre domaine ne sera pas réutilisé sur le vôtre. Firefox a cloisonné son cache réseau en version 85. Safari, lui, le fait depuis 2013. L'argument « mon visiteur a déjà la bibliothèque en cache » ne tient plus depuis plusieurs années.
- L'URL complète, query string comprise : `?v=2` crée une nouvelle entrée
- La méthode HTTP (seules les réponses à des requêtes sûres sont réutilisées)
- Les variantes déclarées par `Vary` : `Vary: Accept-Encoding` stocke une version gzip et une version brotli
- Le site de premier niveau, depuis le partitionnement des caches
Les en-têtes qui décident de tout
La mécanique est décrite par la RFC 9111 (juin 2022), qui remplace la RFC 7234. En cas de conflit, `Cache-Control` prime sur le vieil `Expires`.
La revalidation passe par `ETag` et `Last-Modified`. Le navigateur renvoie la valeur dans `If-None-Match` ou `If-Modified-Since` ; si rien n'a bougé, le serveur répond 304 Not Modified, sans corps. Vous payez un aller-retour réseau et quelques centaines d'octets au lieu du fichier entier. C'est ce que vous reproduisez en ligne de commande avec `curl -I -H 'If-None-Match: "abc123"' https://exemple.fr/style.css`.
Sans en-tête explicite, le navigateur devine. La RFC 9111 autorise une fraîcheur heuristique, calculée en pratique autour de 10 % de l'écart entre `Date` et `Last-Modified` : un fichier modifié il y a 100 jours peut rester servi depuis le disque pendant 10 jours. Le comportement varie d'un moteur à l'autre, donc une absence de `Cache-Control` est une décision par défaut que vous ne contrôlez pas.
| Directive | Effet réel | Usage typique |
|---|---|---|
| max-age=31536000 | fraîche pendant 1 an (31 536 000 secondes) | fichier au nom haché, `app.4f3a1b.js` |
| no-cache | stockée, mais revalidée à chaque usage | HTML d'un site qui change |
| no-store | jamais écrite sur disque ni en mémoire | page bancaire, espace client |
| private | cache du navigateur seulement, pas les proxies ni le CDN | réponse personnalisée par utilisateur |
| immutable | pas de revalidation même sur rechargement (RFC 8246) | assets versionnés par empreinte |
| stale-while-revalidate=60 | sert le périmé et rafraîchit en arrière-plan (RFC 5861) | JSON d'une API de listing |
no-cache ne veut pas dire « pas de cache »
C'est la confusion qui coûte le plus cher sur ce sujet. `no-cache` permet le stockage et exige seulement une revalidation avant chaque réutilisation. L'écriture, c'est `no-store` qui l'interdit. Si un développeur met `no-cache` sur une page qui contient un numéro de dossier, ce contenu reste bel et bien sur le disque du poste.
Dans la même famille, `must-revalidate` ne fait rien tant que la réponse est fraîche : il interdit de servir du contenu périmé quand le serveur est injoignable.
Quatre autres caches portent le même nom dans les conversations et n'ont rien à voir : le cache du résolveur DNS (voir [[cache]]), qui ne bouge pas quand vous videz le navigateur ; le cache du CDN, qui garde sa copie même après une purge locale ; le back/forward cache, qui conserve la page entière en mémoire avec son état JavaScript et que `Cache-Control: no-store` rend inéligible ; le stockage local (`localStorage`, IndexedDB, cookies), que « vider le cache » ne touche pas forcément selon la case cochée.
D'où les tickets insolubles : la page est à jour chez vous et périmée chez le client, parce que la copie fautive n'est pas dans le cache que vous avez vidé.
Le cas qui casse un déploiement
Cas fréquent : les assets ont une empreinte dans leur nom et partent en `max-age=31536000, immutable`, alors que le `index.html` est servi avec un `max-age=3600` hérité d'une config Nginx par défaut. Vous déployez. `app.a1b2c3.js` laisse sa place à `app.d4e5f6.js`. Durant l'heure suivante, une partie des visiteurs charge l'ancien HTML depuis son disque, réclame un fichier qui n'existe plus, obtient un 404 et affiche une page blanche, avec un `ChunkLoadError` dans la console.
Le serveur est à jour. Le navigateur, non.
La parade tient en quelques règles, et surtout dans l'ordre inverse de celui qu'on applique d'instinct : c'est le document HTML qui doit être revalidé en permanence, pas les fichiers qu'il référence.
- HTML et réponses d'API : `Cache-Control: no-cache` plus un `ETag`, le 304 coûte presque rien
- JS, CSS, polices, images versionnées par empreinte : `max-age=31536000, immutable`
- Garder les anciens fichiers hachés en ligne quelques jours après la mise en production
- Purger le CDN après le déploiement, jamais avant (voir [[cdn]])
- `Clear-Site-Data: "cache"` en dernier recours, en sachant que son support est inégal et que Safari ne l'implémente pas
Inspecter et vider sans fausser le diagnostic
Commencez par les en-têtes, pas par l'interface : `curl -sI https://exemple.fr/ | grep -iE 'cache|etag|age|expires'`. La présence d'un `Age` non nul indique qu'un cache partagé a répondu, donc que vous ne testez pas l'origine.
Un rechargement forcé (Ctrl+Shift+R, Cmd+Shift+R) ne dit rien de l'expérience d'un visiteur ordinaire. Le navigateur ajoute en effet `Cache-Control: no-cache` et `Pragma: no-cache` à la requête, ce qu'un visiteur normal n'envoie jamais. Quant à la case « Disable cache » de DevTools, elle n'agit que tant que le panneau reste ouvert. Le test le plus honnête pour reproduire un état réel reste une fenêtre privée neuve, à condition de savoir qu'elle démarre d'un cache vide, pas d'un cache périmé.
Firefox liste encore ses entrées via `about:cache?storage=disk`. Chrome a retiré l'équivalent, il reste DevTools et `chrome://net-internals/#dns` pour le volet DNS, qui est un autre cache.
Attention aussi à `Vary`. Un `Vary: User-Agent` multiplie les variantes stockées et fait chuter le taux de réutilisation, puisque chaque chaîne d'[[agent-utilisateur]] produit sa propre entrée.
Cache et crawl : le 304 qui économise du budget
Googlebot gère `If-Modified-Since` et `ETag`. Répondre 304 quand la page n'a pas changé réduit la bande passante consommée et le budget de crawl dépensé sur des pages stables. Ce n'est pas la même logique qu'un navigateur : Google décide de ses revisites selon ses propres signaux, un `max-age` long ne lui interdit rien et ne garantit pas davantage de passages. Les détails des réponses conditionnelles sont dans la fiche [[codes-statut-http]].
Un serveur mal configuré qui renvoie 200 avec le corps complet à chaque requête conditionnelle gaspille les deux côtés.
Côté mesure, gardez en tête que le cache ne change rien à la première visite d'un internaute. Il agit sur les visites suivantes, et les données de terrain agrègent les deux sans les séparer : un gain de performance obtenu uniquement par le cache sera donc dilué dans les chiffres publics.
Questions fréquentes
Vider le cache supprime-t-il mes mots de passe et mes sessions ?
Non, si vous ne cochez que le cache. Les identifiants enregistrés et les sessions vivent dans les cookies et le stockage local, qui sont des cases distinctes dans la boîte de dialogue. Cochez « cookies et données de sites » et vous serez déconnecté partout.
Pourquoi mon site modifié s’affiche-t-il encore dans son ancienne version ?
Trois suspects, à éliminer dans cet ordre : le HTML servi avec un `max-age` trop long, le CDN qui garde sa copie, un service worker qui sert la page depuis la Cache Storage API sans consulter le réseau. Un `curl -I` sur l'URL vous dit lequel, puisque vous y verrez l'en-tête réel et un éventuel `Age`.
Faut-il mettre no-cache ou no-store sur une page de paiement ?
`no-store`. `no-cache` autorise l'écriture de la réponse sur le disque du poste, revalidation ou pas. `no-store` rend aussi la page inéligible au back/forward cache, ce qui évite qu'un retour arrière réaffiche un montant ou un numéro de commande.
Combien de temps garder un fichier JS en cache ?
Un an (`max-age=31536000`) à condition que son nom contienne une empreinte du contenu, parce qu'une nouvelle version produit alors une nouvelle URL. Sans empreinte dans le nom, descendez à quelques minutes ou passez par la revalidation, sinon vous n'avez plus aucun moyen de corriger un bug chez les visiteurs déjà servis.
Le cache fausse-t-il mes tests de performance ?
Oui, dans les deux sens. Un test lancé depuis votre navigateur habituel mesure un parcours déjà réchauffé ; un test en fenêtre privée mesure un cas plus défavorable que la réalité d'un visiteur récurrent. Mesurez les deux et dites lequel vous publiez.
Testez vos connaissances
À lire aussi
cache · codes statut http · cdn · agent utilisateur