Convert XML to JSON - Fast & Simple

Downloads in past


1.1.76 months ago4 years agoMinified + gzip package size for simple-xml-to-json in KB


A simple XML to JSON converter
npm version Test CI codecov


Simply install using NPM in your project directory
npm install simple-xml-to-json

Usage and API

  1. convertXML(xmlToConvert ,customConverter)

* `xmlToConvert` \<string\>
* `customConverter` \<function\>
* Returns: \<JSON\> by default or other if `customConverter` is used

  1. createAST(xmlToConvert)

* `xmlToConvert` \<string\>
* Returns: An AST representation of the XML \<JSON\>
Code Example: ```javascript const {convertXML, createAST} = require("simple-xml-to-json")
const myJson = convertXML(myXMLString) const myYaml = convertXML(myXMLString, yamlConverter) const myAst = createAST(myXMLString) ````

TS Typescript compatible

Notes and how to use code

  1. The easiest thing to start is to run node example/example.js in your terminal and see what happens.
  2. There's the xmlToJson.js file for convenience. Just pass in the XML as a String.
  3. It's MIT licensed so you can do whatever :)
  4. Profit

How this works in a nutshell

  1. The library converts the XML to an AST
  2. There is a JSON converter that takes the AST and spits out a JSON
  3. You can write your own converters if you need XML-to-ANY-OTHER-FORMAT


Take these results with a grain of salt.\ According to a simple benchmark test I performed in April 2020 with a random XML. YMMV. Benchmark Chart

Current Drawbacks

  1. No support for XSD
  2. All values are translated to strings in JSON
  3. There are currently reserved words in the JSON converter:
* "content" 
* "children"

so you cannot by default have an attribute with that name and free text as the content of the element or have nested elements as children.

*If you need to, you can write your own converter from the AST created by the parser, and pass it as a 2nd parameter after the xml string*