Le Web Storage : localStorage vs sessionStorage

FondamentalPrincipes 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.

FondamentalMé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. Renvoie null si la clé n'existe pas.

  • JSON.stringify() / JSON.parse() : nécessaires pour stocker et récupérer des objets ou tableaux complexes.

1
// 1. Exemple avec localStorage (Stockage de chaînes simples)
2
localStorage.setItem("theme", "sombre");
3
const themeUtilisateur = localStorage.getItem("theme"); 
4
console.log(themeUtilisateur); // "sombre"
5
6
// 2. Exemple avec sessionStorage (Stockage temporaire)
7
sessionStorage.setItem("jetonSession", "abc123xyz");
8
const jeton = sessionStorage.getItem("jetonSession");
9
10
// 3. Stockage d'objets complexes (Sérialisation via JSON)
11
const utilisateur = { nom: "Martin", rôle: "Admin" };
12
13
// Écriture : conversion de l'objet en chaîne JSON
14
localStorage.setItem("user", JSON.stringify(utilisateur));
15
16
// Lecture : parsing de la chaîne JSON en objet JavaScript
17
const userStocke = JSON.parse(localStorage.getItem("user"));
18
console.log(userStocke.nom); // "Martin"

FondamentalAutres 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.

1
// Supprimer une valeur spécifique
2
localStorage.removeItem("theme");
3
4
// Effacer tout le stockage du domaine
5
localStorage.clear();

AttentionÀ retenir

  • localStorage conserve les données indéfiniment, tandis que sessionStorage les 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() et JSON.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.

QCM 1 : Persistance de localStorage

QCM 2 : Portée de sessionStorage

QCM 3 : Type des données sauvegardées

QCM 4 : Stockage d'un objet JavaScript

QCM 5 : Récupération d'une clé inexistante