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

Ordinateur portable, carnet, téléphone et tasse sur un bureau
Illustration

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.

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.

Contenu mis à jour le 5 octobre 2026

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.

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 conservationÉtat de l’interface après échec d’écriture
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.