XML naar JSON omzetten

Deze pagina is voor een ontwikkelaar die iets binnenkrijgt dat hij niet zelf heeft ontworpen: een SOAP-respons, een RSS- of Atom-feed, een export van een partner, een configuratiebestand uit een oudere stack. De uitvoer wordt in code gebruikt, dus de exacte sleutelnamen en structuur tellen zwaarder dan de opmaak eromheen.

Wat hier het meest tijd bespaart om vooraf te weten, is niet hoe de omzetting werkt in het algemeen, maar het specifieke gedrag hieronder — gemeten, niet aangenomen.

Met de parserinstellingen die deze site gebruikt, levert precies één `<item>`-element in het bronbestand een gewoon object op, terwijl twee of meer `<item>`-elementen een array opleveren. De vorm van het resultaat hangt dus af van de data, niet van het schema.

Dat is precies het soort verrassing dat een script laat crashen wanneer een feed op een dag toevallig maar één artikel bevat: code die `.map()` aanroept op wat normaal een array is, breekt zodra er die ene dag maar één item is en het resultaat plots een los object wordt.

Schrijf de code die de uitvoer van deze omzetting verwerkt zo dat hij zowel een enkel object als een array van dezelfde vorm accepteert — bijvoorbeeld door een enkel object eerst in een array van één element te wikkelen voordat de rest van de logica erop draait.

Dat is de robuustere aanpak dan aannemen dat een veld altijd een array is, precies omdat deze omzetting die aanname niet garandeert.

XML-attributen worden in het JSON-resultaat sleutels met een `@`-voorvoegsel, zodat ze te onderscheiden blijven van gewone kindelementen met dezelfde naam. Tekstinhoud die naast kindelementen in hetzelfde element staat, komt terecht onder een `#text`-sleutel.

Voor een SOAP-respons met veel attributen op elk element is dat een consistente, voorspelbare regel om tegen te programmeren, ook al oogt de `@`- en `#text`-notatie ongebruikelijk voor wie er voor het eerst mee werkt.

De `<?xml … ?>`-declaratie bovenaan het bronbestand krijgt een eigen sleutel in het resultaat in plaats van te worden weggelaten. Voor de meeste toepassingen is dat veld niet relevant en kan het na het parsen worden genegeerd.

Voor een script dat specifiek de opgegeven karaktercodering of XML-versie nodig heeft, staat die informatie dus wel beschikbaar in het resultaat.

Een waarde die er numeriek uitziet, wordt automatisch als getal geïnterpreteerd in het JSON-resultaat in plaats van als tekststring. Voor een veld dat eigenlijk een identificatiecode is die toevallig numeriek oogt, zoals een postcode met voorloopnul, kan dat de voorloopnul laten verdwijnen.

Controleer daarom velden die bedoeld zijn als tekst maar er numeriek uitzien, vooral in een export waarin ID’s of codes met vaste lengte voorkomen.

De omzetting draait volledig in de browser; het bestand wordt niet naar een server gestuurd. Voor een payload met gevoelige gegevens uit een intern systeem is dat relevant.

De limiet op het gratis plan is 100 MB per bestand.

Tot honderd XML-bestanden tegelijk kunnen in één sessie worden omgezet, elk met een eigen voortgangsindicator, en het resultaat komt terug als losse bestanden of als ZIP.

Bruikbaar wanneer een systeem elke dag een nieuw XML-exportbestand aflevert dat naar dezelfde JSON-structuur moet.