Comment convertir un CSV en JSON : transformer des lignes de tableur en objets propres

Les tableurs et le code parlent des langages différents. Un fichier CSV est parfait pour une personne qui parcourt des lignes dans Excel, mais dès que vous devez injecter ces données dans une API, un fichier de configuration ou une application JavaScript, c’est du JSON que vous voulez. Convertir de l’un vers l’autre fait partie du quotidien du développement et cela devrait prendre quelques secondes. Ce guide explique ce qui se passe réellement lors de la conversion et comment le faire en toute confidentialité avec l’outil gratuit CSV vers JSON.

À quoi servent le CSV et le JSON

CSV (valeurs séparées par des virgules) est un format plat et tabulaire. Chaque ligne est une rangée et les virgules séparent les colonnes. Il est compact, s’ouvre dans n’importe quel tableur et reste facile à lire et à modifier pour les non-développeurs. Ce qu’il ne sait pas faire, c’est exprimer une structure : il n’existe aucun moyen propre d’imbriquer des données ni d’indiquer ce que signifie chaque valeur, au-delà d’une ligne d’en-tête.

JSON (notation d’objets JavaScript) est conçu pour la structure. Il utilise des clés nommées, prend en charge l’imbrication et constitue le langage par défaut des API web et des applications JavaScript. Lorsque votre code doit parcourir des enregistrements et lire des champs par leur nom, c’est du JSON qu’il attend.

La conversion est donc en réalité une traduction d’une ‘grille que lit un humain’ vers des ‘enregistrements étiquetés que lit un programme’.

Comment les lignes deviennent des objets

Le mécanisme est simple une fois qu’on le voit. Prenons ce CSV :

• name,email,age
• Ada,[email protected],36
• Linus,[email protected],29

La première ligne est l’en-tête. Chaque ligne restante devient un objet JSON, et chaque cellule d’en-tête devient une clé. Le résultat est un tableau d’objets : [{"name": "Ada", "email": "[email protected]", "age": "36"}, ...]. Une ligne entre, un objet sort, les noms de colonnes assurant l’étiquetage.

Cette forme de tableau est exactement ce que la plupart des API et des frameworks front-end veulent recevoir, ce qui explique pourquoi cette conversion revient si souvent.

Pourquoi les développeurs convertissent le CSV en JSON

Vous avez recours à cette opération chaque fois que des données en forme de tableur doivent rencontrer du code. Les cas courants sont notamment :

• Initialiser une application ou une base de données à partir d’une liste que quelqu’un tient à jour dans Excel ou Google Sheets.
• Envoyer des données à une API qui n’accepte qu’un corps au format JSON.
• Alimenter un front end, où un tableau JSON correspond directement à une liste de composants.
• Écrire des jeux de données pour les tests (fixtures), en transformant un tableur rapide de cas en une entrée structurée.

Dans chaque cas, un collègue peut garder la source facile d’accès sous forme de tableur pendant que votre code consomme le JSON.

Comment convertir un CSV en JSON dans votre navigateur

L’outil gratuit CSV vers JSON fonctionne entièrement dans votre navigateur, de sorte que vos données ne sont jamais envoyées à un serveur. C’est important lorsque les lignes contiennent des fiches clients, des adresses e-mail ou tout ce que vous ne colleriez pas dans un site web quelconque.

1. Ouvrez l’outil et collez votre CSV, ou chargez un fichier .csv.
2. Assurez-vous que la première ligne est bien votre en-tête. Ces cellules deviennent les clés de chaque objet.
3. Lisez la sortie JSON, un tableau d’objets, et copiez-la directement dans votre code ou votre configuration.

Comme le traitement a lieu dans l’onglet, vous pouvez convertir des données sensibles en toute sécurité, sans qu’elles quittent votre machine.

En-têtes, types et quelques pièges

Une conversion propre dépend surtout d’une entrée propre. Gardez ceci à l’esprit :

• La ligne d’en-tête pilote tout. Si une colonne n’a pas d’en-tête, ses valeurs n’ont nulle part de pertinent où atterrir. Nommez chaque colonne.
• Les valeurs ressortent sous forme de chaînes de caractères. Un CSV n’enregistre pas les types, donc 36 arrive sous la forme "36". Convertissez-le en nombre dans votre code si vous avez besoin de faire des calculs.
• Mettez entre guillemets les champs qui contiennent des virgules. Une valeur comme Smith, Jr. doit être entourée de guillemets dans le CSV, sinon elle sera lue comme deux colonnes.

Quand la sortie semble incorrecte, la cause est presque toujours un en-tête manquant ou une virgule non protégée par des guillemets dans la source.

Outils connexes dont vous aurez probablement besoin

La conversion fonctionne dans les deux sens. Lorsque vous devez rendre des données structurées à quelqu’un sous forme de tableur, l’outil JSON vers CSV les aplatit de nouveau en lignes. Une fois que vous avez du JSON, le Formateur JSON l’indente et le valide pour que vous puissiez réellement lire la structure et repérer un crochet égaré. Et si vos données d’origine sont arrivées en XML plutôt qu’en tableur, l’outil XML vers JSON les met dans la même forme d’objet que celle attendue par votre code.

La version courte

Le CSV est une grille pour les humains ; le JSON, des enregistrements étiquetés pour le code. Convertir, c’est transformer chaque ligne en objet, la ligne d’en-tête fournissant les clés. Gardez vos en-têtes propres, mettez entre guillemets tout champ contenant des virgules et n’oubliez pas que les nombres arrivent sous forme de chaînes de caractères. Quand vous avez besoin d’une conversion rapide et confidentielle, l’outil gratuit CSV vers JSON la réalise dans votre navigateur sans rien envoyer.