Convertisseur XML vers JSON

Qu'est-ce que la Conversion XML vers JSON et Comment Fonctionne-t-elle ?

// Convert XML to JSON in Node.js using fast-xml-parser
import { XMLParser } from 'fast-xml-parser';

const xml = `<catalog>
  <product id="P01">
    <name>Wireless Headphones</name>
    <price currency="USD">79.99</price>
  </product>
</catalog>`;

const parser = new XMLParser({
  ignoreAttributes: false,      // preserve attributes
  attributeNamePrefix: '@_',    // @_ prefix for attributes
  textNodeName: '#text',        // #text for mixed element content
  parseAttributeValue: false,   // no type coercion on attributes
  parseTagValue: false,         // no type coercion on element text
});

const result = parser.parse(xml);
console.log(JSON.stringify(result, null, 2));
// {
//   "catalog": {
//     "product": {
//       "@_id": "P01",
//       "name": "Wireless Headphones",
//       "price": {
//         "@_currency": "USD",
//         "#text": "79.99"
//       }
//     }
//   }
// }

Fonctionnalités clés

Exemples

<?xml version="1.0" encoding="UTF-8"?>
<appConfig version="2.1" env="production">
  <database>
    <host>db.example.com</host>
    <port>5432</port>
    <name>myapp_prod</name>
    <pool max="10" min="2"/>
  </database>
  <cache enabled="true">
    <ttl>3600</ttl>
    <driver>redis</driver>
  </cache>
</appConfig>

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://go-tools.org/tools/xml-to-json</loc>
    <lastmod>2026-05-29</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.8</priority>
  </url>
  <url>
    <loc>https://go-tools.org/tools/json-to-xml</loc>
    <lastmod>2026-05-29</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.8</priority>
  </url>
</urlset>

<item>
  <title>XML to JSON: A Practical Guide</title>
  <link>https://go-tools.org/blog/xml-to-json-guide</link>
  <pubDate>Thu, 29 May 2026 00:00:00 GMT</pubDate>
  <category>Developer Tools</category>
  <description>Learn how XML attributes map to @_ keys, how repeated elements become arrays, and why values stay strings in any XML-to-JSON conversion.</description>
  <guid isPermaLink="true">https://go-tools.org/blog/xml-to-json-guide</guid>
</item>

Comment utiliser

1. 1

   Collez votre XML

   Saisissez ou collez votre XML dans le champ de saisie ci-dessus. Vous pouvez aussi cliquer sur « Charger un exemple » pour essayer un échantillon — un fichier de configuration, un fragment de sitemap ou un élément RSS.

2. 2

   Consultez la sortie JSON en direct

   Le JSON apparaît instantanément dans le panneau de sortie. Les attributs deviennent des clés préfixées par @_, le contenu textuel des éléments mixtes devient #text, et les éléments frères répétés deviennent des tableaux. Ajustez l'indentation (2 ou 4 espaces) selon vos besoins.

3. 3

   Copiez ou téléchargez

   Cliquez sur Copier pour récupérer le JSON dans votre presse-papiers, ou sur Télécharger pour le sauvegarder en fichier .json prêt pour votre application, API ou pipeline de données.

Pièges courants de conversion

// XML: <timeout>30</timeout>
// JSON output: { "timeout": "30" }  ← string, not number
// Dangerous: comparing as-is
if (config.timeout > 25) { ... }  // "30" > 25 coerces, but fragile

// XML: <timeout>30</timeout>
// JSON output: { "timeout": "30" }
// Safe: explicit coercion where you know the type
if (parseInt(config.timeout, 10) > 25) { ... }

// XML with one item: <root><item>a</item></root>
// JSON: { "root": { "item": "a" } }  ← string, not array
result.root.item.forEach(i => console.log(i));  // TypeError: not a function

// Normalize to array regardless of count
const items = [].concat(result.root?.item ?? []);
items.forEach(i => console.log(i));  // safe for 0, 1, or many

// XML: <price currency="USD">29.99</price>
// JSON: { "price": { "@_currency": "USD", "#text": "29.99" } }
const amount = result.price;  // { "@_currency": "USD", "#text": "29.99" }, not "29.99"

// Handle both plain string and @_/#text object
const raw = result.price;
const amount = typeof raw === 'object' ? raw['#text'] : raw;  // "29.99"

<!-- Unescaped & — well-formedness error -->
<query>name = 'Alice' & role = 'admin'</query>

<!-- Escaped & — valid XML -->
<query>name = 'Alice' &amp; role = 'admin'</query>

// XML: <zipCode>01234</zipCode>
// This tool outputs: { "zipCode": "01234" }  ← correct
// But if a downstream schema coerces:
// { zipCode: z.number() }  → 1234  ← leading zero lost

// Declare ZIP codes and other padded identifiers as strings
// { zipCode: z.string() }  → "01234"  ← correct

Cas d'utilisation courants

Consommation d'APIs SOAP et XML héritées

Les services d'entreprise hérités (banque, assurance, logistique) exposent souvent des APIs SOAP qui retournent du XML. Convertissez la réponse en JSON pour travailler avec les données en utilisant les outils JavaScript modernes, les stocker dans une base de données documentaire ou les transmettre à un consommateur d'API REST.

Traitement des flux RSS et Atom

Les flux RSS 2.0 et Atom 1.0 sont du XML. Convertissez le XML du flux en JSON pour extraire les titres, les liens, les dates de publication et les descriptions pour les agrégateurs de flux, les pipelines de contenu et les systèmes de notification, sans dépendance à une bibliothèque d'analyse XML.

Analyse des fichiers Sitemap

Les fichiers sitemap.xml énumèrent les URL d'un site avec des métadonnées. Convertissez un sitemap en JSON pour analyser la couverture des URL, construire des files d'attente d'exploration, comparer les sitemaps entre environnements ou alimenter les URL dans un vérificateur de liens ou un outil d'audit SEO.

Transformation des fichiers de configuration

De nombreux systèmes d'entreprise (Spring, Maven, Ant, JBoss, Tomcat) utilisent des fichiers de configuration XML. Convertissez-les en JSON pour l'analyse, les scripts de migration, la génération de documentation ou l'importation dans des outils qui parlent nativement JSON.

Développement mobile et Android

Les ressources Android, les fichiers de mise en page et AndroidManifest.xml sont tous du XML. Convertissez-les en JSON pour les scripts d'analyse, l'audit automatisé ou la génération de documentation sur les permissions déclarées, les activités et les valeurs de ressources.

Migration de données et ETL

Les exports de données des systèmes d'entreprise (ERP, CRM, paie) arrivent souvent en XML. Convertissez en JSON comme première étape d'un pipeline ETL pour charger les données dans un magasin de données natif JSON comme MongoDB, Firestore ou une API REST.

Détails techniques

DOMParser du navigateur pour l'analyse XML

L'entrée XML est analysée avec le DOMParser natif du navigateur avec le type MIME 'text/xml' — le même moteur utilisé pour rendre SVG et XHTML. Il est entièrement conforme à XML 1.0 et signale les erreurs de bonne formation avec les informations de ligne et de colonne. Cette approche gère correctement les espaces de noms, les sections CDATA, les instructions de traitement et les références d'entité sans dépendance tierce.

Sérialisation DOM vers JSON récursive

Après l'analyse, l'outil parcourt l'arborescence DOM de manière récursive. Les nœuds éléments deviennent des objets JSON ; leurs attributs deviennent des clés préfixées par @_ ; les éléments ne contenant que du texte deviennent des valeurs de chaîne simples ; les éléments ayant à la fois des attributs et du contenu textuel obtiennent une clé #text pour le contenu textuel. Les éléments frères du même nom sont regroupés et émis comme tableau JSON. Les nœuds texte composés uniquement d'espaces entre les éléments sont ignorés.

Aucune coercition de type — Préservation des chaînes

Toutes les valeurs d'attributs et les contenus textuels sont écrits dans la sortie JSON comme des chaînes. Aucun parseInt, parseFloat ou analyse booléenne n'est appliqué. C'est un choix de conception délibéré pour éviter la corruption silencieuse des données pour les valeurs avec zéro initial, les décimales sensibles à la précision et les chaînes ressemblant à des booléens. La coercition de type, si nécessaire, doit être appliquée explicitement dans le code en aval.

100 % basé sur le navigateur — Aucun envoi, aucun serveur

Tout le traitement s'exécute dans le moteur JavaScript de votre navigateur. Aucune donnée n'est transmise sur le réseau à aucun moment. Les entrées de plus de 200 Ko passent automatiquement du mode en direct au mode manuel (nécessitant un clic explicite sur Convertir) pour maintenir la réactivité du navigateur et éviter le blocage du thread principal lors d'un parcours DOM intensif.

Bonnes pratiques

Validez d'abord la bonne formation XML

Si votre source XML est écrite à la main ou générée par un système qui produit parfois des sorties incorrectes, validez-la avant de convertir. Utilisez le bouton Valider du Formateur XML pour confirmer que le XML est bien formé et obtenir des localisations précises des erreurs pour tout problème.

Normalisez les champs un-ou-plusieurs en tableaux

Quand votre schéma XML permet un ou plusieurs éléments enfants du même nom, la sortie JSON sera un objet pour un élément et un tableau pour plusieurs. Normalisez toujours ces champs dans votre code consommateur : const items = [].concat(result.items ?? []) — c'est sûr pour zéro, un ou plusieurs éléments et empêche les TypeError.

Appliquez la coercition de type explicitement et sélectivement

Comme cet outil préserve toutes les valeurs comme des chaînes, appliquez la coercition de type délibérément dans votre code pour les champs spécifiques qui en ont besoin. Utiliser parseInt(val, 10) pour un champ entier connu est sûr. Appliquer la coercition largement avec Number(val) risque de corrompre les valeurs avec zéro initial, les chaînes vides et les décimales sensibles à la précision.

Vérifiez #text lors de l'accès aux valeurs d'éléments

Si un élément peut avoir des attributs dans certaines charges utiles et non dans d'autres, sa valeur JSON sera soit une chaîne simple (sans attributs) soit un objet avec des clés @_ et une clé #text (avec attributs). Écrivez des accesseurs robustes : const val = typeof node === 'object' ? node['#text'] : node. Ce modèle gère les deux formes et évite les valeurs undefined silencieuses.

Pour un travail XML sans perte, utilisez le Formateur XML

La conversion XML vers JSON supprime les commentaires, les instructions de traitement et la sémantique des espaces de noms. Si vous devez préserver tout le contenu XML exactement, utilisez le Formateur XML pour embellir, minifier et valider sans aucune perte. Convertissez en JSON uniquement quand vous devez travailler avec les données dans un contexte natif JSON.

Questions fréquentes