Formations — 1 037 leçons en français

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 — et parse peut é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.

Lire l'explication détaillée et faire le quiz →

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.