Accueil › JavaScript › Garder des données dans le navigateur
Garder des données dans le navigateur
Formulaires et stockageintermediaire
localStorage.setItem("theme", "sombre");
localStorage.getItem("theme"); // "sombre"
localStorage.getItem("absent"); // null
localStorage.removeItem("theme");
localStorage.clear(); // tout
Tout est du texte
localStorage.setItem("compteur", 5);
localStorage.getItem("compteur") + 1; // "51" ⚠️
Number(localStorage.getItem("compteur")); // 5 ✅
La conversion en chaîne est silencieuse à l'écriture. Pour un objet, il faut sérialiser :
localStorage.setItem("profil", JSON.stringify({ nom: "Anne" }));
const profil = JSON.parse(localStorage.getItem("profil") ?? "null");
Toute écriture peut échouer
function garder(cle, valeur) {
try {
localStorage.setItem(cle, JSON.stringify(valeur));
} catch {
// Quota dépassé, ou stockage désactivé : on continue sans.
}
}
Navigation privée, réglages stricts, quota plein : l'accès lève une erreur. Une fonctionnalité de confort ne doit jamais faire tomber l'application.
local ou session
localStorage |
sessionStorage |
|
|---|---|---|
| Durée | jusqu'à effacement explicite | fermeture de l'onglet |
| Portée | toutes les fenêtres du site | un seul onglet |
| Taille | ~5 Mo | ~5 Mo |
Préférences d'affichage, brouillon d'article : localStorage. Étape d'un
tunnel de commande, formulaire en plusieurs écrans : sessionStorage.
Les termes à connaître
- localStorage
Un stockage clé → valeur qui survit à la fermeture du navigateur. Environ 5 Mo, propre à une origine, et synchrone — il bloque le fil principal.
- sessionStorage
La même interface, mais effacée à la fermeture de l'onglet. Chaque onglet a le sien, même sur le même site.
- Origine
Le triplet protocole + domaine + port. Le stockage est cloisonné par origine : un autre site ne peut jamais lire le vôtre.
- Sérialisation
La conversion en texte, seul format accepté.
JSON.stringifyà l'écriture,JSON.parseà la lecture — etparsepeut échouer.- QuotaExceededError
L'erreur levée quand le stockage est plein, ou qu'il est désactivé — navigation privée, réglages stricts. Toute écriture doit être protégée.
- IndexedDB
Le stockage pour les gros volumes et les données structurées. Asynchrone, sans limite pratique, mais d'un usage nettement plus lourd.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.