如何在Node.js中使用xmlbuilder导入文件及操作现有XML？

Great question! While xmlbuilder is best known for building XML documents from scratch, you absolutely can work with existing XML files—you just need a small workaround (or an upgrade to the newer version of the library). Let me break this down for you:

Option 1: Use xmlbuilder (v15 and below) with an XML Parser #

Older versions of xmlbuilder don't have built-in parsing capabilities, so you'll need to pair it with an XML-to-JavaScript parser like xml2js or fast-xml-parser. Here's a step-by-step example with xml2js:

1. First, install the required packages:

npm install xmlbuilder xml2js

2. Then, write code to parse your existing XML, convert it to a JS object, and import it into xmlbuilder for manipulation:

const fs = require('fs');
const xml2js = require('xml2js');
const { create } = require('xmlbuilder');

// Read your existing XML file
const rawXml = fs.readFileSync('your-file.xml', 'utf8');

// Parse XML to a JavaScript object
const parser = new xml2js.Parser({
  explicitArray: false, // Avoid wrapping single elements in arrays
  preserveChildrenOrder: true // Maintain the original element order
});

parser.parseString(rawXml, (err, parsedXml) => {
  if (err) {
    console.error('Failed to parse XML:', err);
    return;
  }

  // Create an xmlbuilder document from the parsed object
  const doc = create(parsedXml, { headless: false });

  // Now you can manipulate the XML just like you would when building from scratch
  // Example 1: Add a new element with attributes
  doc.root().ele('new-section', { id: 'sec-001' }).txt('New content here');

  // Example 2: Update an existing element's text
  doc.root().find('./existing-element').text('Updated text content');

  // Example 3: Modify an attribute
  doc.root().att('last-modified', new Date().toISOString());

  // Output the updated XML to a file
  const updatedXml = doc.end({ pretty: true });
  fs.writeFileSync('updated-file.xml', updatedXml);
});

Option 2: Upgrade to xmlbuilder2 (Recommended) #

The newer xmlbuilder2 library has built-in XML parsing, which makes working with existing files much simpler—no extra parser needed. Here's how to use it:

1. Install xmlbuilder2:

npm install xmlbuilder2

2. Parse and manipulate your XML directly:

const fs = require('fs');
const { parse } = require('xmlbuilder2');

// Read and parse the XML file in one step
const doc = parse(fs.readFileSync('your-file.xml', 'utf8'));

// Manipulate the document
// Example: Update a book's publication year
doc.root()
  .children('book')
  .where({ attr: { isbn: '978-1234567890' } })
  .attr('year', '2024');

// Example: Add a new author to a book
doc.root()
  .children('book')
  .first()
  .ele('author').txt('Jane Doe');

// Convert back to XML string and save
const updatedXml = doc.end({ prettyPrint: true });
fs.writeFileSync('updated-file.xml', updatedXml);

Key Notes #

• For xmlbuilder (v15-), make sure to tweak parser options like explicitArray and preserveChildrenOrder to avoid unexpected behavior with single elements or element order.
• xmlbuilder2 has a more intuitive API and better support for modern JavaScript features, so it's worth upgrading if you can.

内容的提问来源于stack exchange，提问作者Martin Thompson