Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including @wmfs/xml-flatten2csv with all npm packages installed. Try it out:

var xmlFlatten2csv = require("@wmfs/xml-flatten2csv")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

@wmfs/xml-flatten2csv v1.2.0

Flattened XML file to CSV file


Tymly Package npm (scoped) Build Status codecov CodeFactor Dependabot badge Commitizen friendly JavaScript Style Guide license

Takes an XML file and transforms it into a CSV file, based on a mapping you provide.
One XML element and its contents can be transformed into multiple CSV output lines.


$ npm install xml-flatten2csv --save


const xmlFlatten2csv = require('xml-flatten2csv')

    xmlPath: 'path/to/file.xml',
    csvPath: 'path/to/file.csv',
    rootXMLElement: 'Episode',
    pivotPath: '$.People.Person',
    headerMap: [
      ['$.Title', 'title', 'string'],
      ['@.Name', 'name', 'string'],
      [{ test: '@.Age<=16', value: 'yes'}, 'child', 'string'],
      [{ test: '@.Age>16', select: '@.Age'}, 'age', 'integer']
.then(() => console.log("Done!"))
.catch(err => console.error(err))


        <Title>Cape Feare</Title>
                <Name>Sideshow Bob</Name>
        <Title>Homer Loves Flanders</Title>
                <Name>Ned Flanders</Name>


"Cape Feare","Bart","yes",
"Cape Feare","Marge",,36
"Cape Feare","Lisa","yes",
"Cape Feare","Sideshow Bob",,
"Homer Loves Flanders","Homer",,39
"Homer Loves Flanders","Ned Flanders",,60



xmlPathstringA path to the xml input file.
csvPathstringThe path and filename of the generated CSV output file (note that any intermediate folders will be created).
rootXMLElementstringThe XML root tag for each subtree to process,
pivotPathstringThe jsonpath of the elements to split records on
headerMap[array]See the Header Map section for more details.
optionsobjectSee Additional options


options.headerMap has the structure:

    [selector, csvHeader, type],
    [selector, csvHeader, type],
  • selector is either a jsonpath into the subtree, or a condition consisting of a jsonpath test and either a value or a jsonpath into the subtree
  • type must be integer, date or string

For straightforward linear transformations, where one XML subtree maps to one line of CSV output, consider xml2csv instead.

Additional Options

The additional options are a set of key-value pairs -

namespaceHow to handle namespace prefixes - omit to do nothing, 'strip' to remove prefixes, or any other string to replace the ':' with something else
xmllangIf set to 'wrap', when an element has an xml:lang attribute, create an intermediate wrapper element of named for the attribute value. Eg <description xml:lang='en'>Sunny</description> would effectively become <description><en>Sunny</en></description>, and can be addressed as $.description.en in the header map.
transformA transformation function applied to the selected JSON objects before running the header map queries. The modified JSON should be the return value of the function, even if it's changed in-place.


$ npm test



RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free