Le Web Storage : localStorage vs sessionStorage
Fondamental : Principes et différences de stockage
L'API Web Storage permet de stocker des paires clé-valeur directement dans le navigateur du client. Les données sont toujours sauvegardées sous forme de chaînes de caractères (string). Deux mécanismes sont à disposition :
localStorage : stockage persistant. Les données restent conservées même après la fermeture du navigateur ou le redémarrage de la machine, jusqu'à leur suppression explicite ou celle des données du site.
sessionStorage : stockage temporaire. Les données sont conservées uniquement pendant la durée de la session de l'onglet actif et sont supprimées à la fin de cette session, généralement lors de la fermeture de l'onglet.
Capacité : généralement limitée à environ 5 Mo par origine (protocole, domaine et port). La capacité exacte dépend du navigateur et de ses règles de stockage.
Fondamental : Méthodes principales : setItem() et getItem()
Les deux objets partagent exactement la même interface pour écrire et lire des éléments :
setItem('cle', 'valeur'): enregistre une valeur associée à la clé spécifiée.getItem('cle'): récupère la valeur associée. Renvoienullsi la clé n'existe pas.JSON.stringify() / JSON.parse(): nécessaires pour stocker et récupérer des objets ou tableaux complexes.
// 1. Exemple avec localStorage (Stockage de chaînes simples)localStorage.setItem("theme", "sombre");
const themeUtilisateur = localStorage.getItem("theme");
console.log(themeUtilisateur); // "sombre"
// 2. Exemple avec sessionStorage (Stockage temporaire)sessionStorage.setItem("jetonSession", "abc123xyz");
const jeton = sessionStorage.getItem("jetonSession");
// 3. Stockage d'objets complexes (Sérialisation via JSON)const utilisateur = { nom: "Martin", rôle: "Admin" };
// Écriture : conversion de l'objet en chaîne JSONlocalStorage.setItem("user", JSON.stringify(utilisateur));
// Lecture : parsing de la chaîne JSON en objet JavaScriptconst userStocke = JSON.parse(localStorage.getItem("user"));
console.log(userStocke.nom); // "Martin"
Fondamental : Autres méthodes utiles
Suppression d'un élément :
removeItem('cle')efface l'entrée désignée.Vidage complet :
clear()efface toutes les clés enregistrées pour l'origine courante.
// Supprimer une valeur spécifiquelocalStorage.removeItem("theme");
// Effacer tout le stockage du domainelocalStorage.clear();
Attention : À retenir
localStorageconserve les données indéfiniment, tandis quesessionStorageles détruit à la fermeture de l'onglet.Le stockage se fait exclusivement sous forme de chaînes de caractères ; l'utilisation de
JSON.stringify()etJSON.parse()est obligatoire pour manipuler des objets ou tableaux.Les méthodes de manipulation (
setItem(),getItem(),removeItem(),clear()) sont totalement identiques pour les deux types de stockage.