Documentation développeur
TypeScript
Mis à jour le 19 septembre 2026

Convertir XML vers JSON en TypeScript

Analysez du XML et convertissez-le en JSON selon une convention de correspondance explicite en TypeScript.

XML peut représenter des attributs, du texte mixte, des espaces de noms, des éléments répétés et un ordre que JSON ne représente pas directement. Choisissez une bibliothèque et une convention stable, puis testez-les avec de vrais documents.

Démarrage rapide#

L’exemple suivant utilise l’API standard de TypeScript ou une bibliothèque couramment utilisée pour cette tâche.

Exemple#

TypeScript
1// npm install xml2js2import { parseStringPromise } from "xml2js";34const value: unknown = await parseStringPromise(xml, {5  explicitArray: false,6  trim: true,7});89const json: string = JSON.stringify(value, null, );

Opérations courantes#

Ce second exemple couvre une opération fréquente en production ou une manière plus sûre de traiter des entrées réelles.

Variante courante#

TypeScript
1const value: unknown = await parseStringPromise(xml, { explicitArray: false });2// Validate/narrow `value` before treating it as a domain object.

Points importants#

Définissez comment représenter attributs, texte, espaces de noms et éléments répétés, et sécurisez l’analyse des documents XML non fiables.

Bonnes pratiques#

  1. Considérez toute entrée externe comme non fiable et gérez explicitement les erreurs d’analyse ou de validation.
  2. Rendez explicites l’encodage, les unités, les formats et les conventions propres aux bibliothèques aux frontières du système.
  3. Ajoutez des tests couvrant l’entrée vide, le texte Unicode, les entrées invalides et des données représentatives de la production.

Références#

Implémenter XML → JSON dans d'autres langages :