Rechercher
Saisissez au moins deux caractères, sans donnée personnelle.

    BibliothèqueArticles et FAQ Votre projetDemander un devis
    LangueFR
    Guides pratiques

    Tester le stockage local et l’export des données du navigateur

    Une préférence mémorisée ou un carnet conservé dans le navigateur peut faciliter un retour. Il faut pourtant expliquer où les données restent, quand elles peuvent disparaître et comment les récupérer. Le stockage local ne doit pas être la seule copie d’un travail important.

    Voir la méthode

    Personne consultant deux écrans de suivi technique
    Illustration générée par IA

    Décrire où la donnée est conservée

    localStorage conserve des données pour une origine entre sessions ; sessionStorage est lié à la session de page dans un onglet. Une origine distingue notamment protocole, hôte et port. Une donnée conservée sur la version HTTP ne se retrouve donc pas automatiquement sur la version HTTPS.

    La présence du mot « local » ne garantit pas un chiffrement ni une isolation entre les scripts de la même origine. Décrivez la donnée exacte conservée et évitez d’y placer des secrets. Sur un appareil partagé, prévoyez une action d’effacement et expliquez sa portée.

    L’événement storage n’est pas envoyé à la fenêtre qui effectue la modification. Avec localStorage, il peut informer les autres onglets de même origine partageant cette zone de stockage. Avec sessionStorage, il concerne les autres documents de même origine dans le même onglet, par exemple une iframe, pas un autre onglet indépendant. Si une nouvelle fenêtre possède un opener, son sessionStorage peut commencer par une copie ; les deux zones restent ensuite séparées.

    Exemple de recette fictif : deux onglets ouvrent la révision r7 d’un brouillon, puis chacun le modifie. Relire la révision avant de remplacer une valeur peut révéler un conflit, mais ne rend pas la séquence de lecture et d’écriture atomique. L’événement storage n’est ni un verrou ni une synchronisation serveur. Décidez comment conserver les deux modifications ou demander un choix, au lieu d’annoncer une fusion automatique non réalisée.

    Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.

    Stockage entre documents : distinguer notification, copie et synchronisation
    Situation à testerComportement documentéConséquence pour l’interface
    Une fenêtre écrit dans localStorageLes autres contextes de même origine partageant le stockage peuvent recevoir storage.Mettre à jour aussi la fenêtre qui écrit sans attendre son propre événement.
    La fenêtre à l’origine de l’écritureElle ne reçoit pas son propre événement storage.Confirmer localement la réussite réelle de l’écriture.
    Deux onglets indépendants et sessionStorageLeurs zones ne sont pas synchronisées par cet événement.Ne pas promettre la reprise automatique de la saisie dans l’autre onglet.
    Nouvelle fenêtre avec openerUne copie initiale de sessionStorage peut être créée, puis évoluer séparément.Tester les modifications ultérieures ; une copie de départ n’est pas un partage continu.
    • MDN : Événement storage

      Consulté le 22 octobre 2026 ; destinataires de l’événement et différence entre stockages local et de session.

    • MDN : sessionStorage

      Consulté le 22 octobre 2026 ; séparation par onglet et copie initiale éventuelle depuis la fenêtre ouvrante.

    Prévoir l’indisponibilité et la perte

    Les paramètres du navigateur, les quotas, l’effacement volontaire et certains contextes privés peuvent empêcher la conservation ou faire disparaître la copie. Les règles varient selon le navigateur et l’API. Un quota théorique n’est pas une promesse de disponibilité sur l’appareil du visiteur.

    Protégez les lectures et écritures susceptibles d’échouer. Si la conservation ne fonctionne pas, gardez les saisies actives tant que possible et affichez un état explicite : travail utilisable dans cette page, mais copie persistante non confirmée. Ne présentez pas « enregistré » avant le succès réel de l’écriture.

    Offrir une copie exportable et documentée

    Pour un carnet ou une configuration importante, proposez un export avec format, version, date et identifiants stables des éléments. Le fichier doit permettre de reprendre le travail sans dépendre de l’ordre visuel actuel des lignes. Évitez de joindre automatiquement des informations d’appareil ou des données inutiles.

    La demande de téléchargement ne prouve pas que le fichier a été conservé par le visiteur. Formulez le message en conséquence et expliquez comment le ranger. Un export n’est pas un espace de partage sécurisé : son contenu reste à la charge de la personne qui le diffuse.

    Valider entièrement avant d’importer

    Contrôlez taille, format, version, types, champs attendus, longueurs, identifiants connus et doublons. Préparez le résultat en mémoire, puis remplacez les données visibles une fois tous les contrôles terminés. Une erreur ne doit pas laisser la moitié du carnet importée.

    Affichez les notes comme du texte, sans interpréter du HTML. Testez un fichier vide, un JSON tronqué, un ancien format et des chaînes contenant des caractères spéciaux. Si le contenu change de sens après une évolution du site, demandez une nouvelle revue plutôt que de reprendre automatiquement un statut « réussi ».

    Tester l’effacement et la reprise

    Vérifiez ce qu’efface chaque action : saisies actives, clé locale de l’outil ou ensemble d’un compte. Une action sur un outil ne doit pas purger toutes les préférences du site sans nécessité. Les exports précédemment téléchargés restent des copies indépendantes.

    Le budget et le carnet de recette de ce site peuvent être utilisés sans compte. Le carnet s’exporte pour reprendre une revue ; la sélection de l’annuaire mémorise seulement des préférences de consultation quand le stockage est disponible. Contrôlez le comportement de chaque outil au lieu de supposer qu’ils conservent tous les mêmes données.

    Cas de récupération : le fichier s’importe mais des lignes manquent

    Exemple fictif : un carnet de recette exporté contient douze contrôles, mais la restauration n’en montre que neuf. Comparez les identifiants et les champs obligatoires avant de conclure que le téléchargement est valide. Une confirmation d’import sans rapprochement des données ne démontre pas la récupération. Les lignes rejetées doivent être identifiées avec une raison compréhensible, sans effacer le carnet déjà ouvert.

    Gardez un export de l’état initial, travaillez sur une copie et vérifiez quantité, texte, statut et remarques de chaque contrôle. Essayez aussi deux imports successifs du même fichier : le comportement annoncé doit préciser remplacement ou fusion, sans duplication silencieuse. La procédure de reprise reste utilisable si le navigateur refuse toute écriture locale ; elle ne dépend pas seulement d’un indicateur « sauvegardé ».

    Évaluer une remise à zéro ciblée sans effacer silencieusement les brouillons utiles.

    Cas fictif : après une évolution incompatible, des données locales anciennes empêchent le parcours de fonctionner. Sur un profil jetable, inventoriez ce qui sera supprimé et testez les directives retenues. Prévenez la personne si ses brouillons sont concernés. Effacer le navigateur ne révoque pas, à lui seul, les sessions et données conservées sur le serveur.

    • La suppression correspond au périmètre annoncé ; les données utiles sont exportables et la session serveur est traitée séparément.
    • MDN Clear-Site-Data

      En-tête HTTPS signalant au navigateur la suppression de certaines catégories de données associées au site, selon sa prise en charge.

    Documents de référence

    Contenu mis à jour le

    Matrice de recette à adapter au projet

    Ces contrôles proposés utilisent des cas fictifs. Décidez du comportement attendu avec l’équipe, notez le résultat et attribuez les écarts non résolus avant publication.

    Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.

    Cas de test, résultats attendus et preuves utiles
    CasRésultat attenduPreuve à conserver
    Stockage refusé par le navigateurL’outil reste utilisable et ne promet pas une conservationErreur d’écriture provoquée, saisie conservée à l’écran et message exact sur l’absence de sauvegarde.
    Export puis import valideIdentifiants, notes et statuts retrouvent leur correspondanceComparaison des données avant et après
    Import invalide ou avec doublonToutes les saisies existantes sont conservéesMessage de rejet et valeurs initiales
    Effacement du carnetLe carnet est vidé ; les exports externes restent indépendantsRetour à l’état initial et nouvelle saisie

    Questions fréquentes

    localStorage est-il une sauvegarde ?

    Il conserve une copie dans un navigateur pour une origine. L’utilisateur peut l’effacer et le stockage peut être indisponible. Une donnée importante demande une stratégie de copie et de reprise adaptée.

    Pourquoi un autre navigateur ne retrouve-t-il pas mes données ?

    Le stockage est attaché au navigateur, à son profil et à l’origine du site. Une synchronisation entre appareils demande un mécanisme distinct ; elle ne découle pas de localStorage.

    Peut-on importer un fichier trouvé ailleurs ?

    L’outil doit valider entièrement le fichier et traiter les textes sans exécution. Vérifiez aussi sa provenance et le sens des observations : un ancien carnet ne prouve pas l’état actuel du site.