信息圖標
跳過到頁腳內容
  1. IronPDF for Node.js
  2. IronPDF for Node.js 博客
  3. Node 說明
  4. xml2js npm
NODE 說明

xml2js npm（開發者的使用方法）

Darrius Serrant
Darrius Serrant
更新日期:

開發人員可以通過將 XML2JS 與 IronPDF 組合在 Node.js 中輕鬆整合 XML 數據解析和 PDF 創建功能到他們的應用程序中。 一個受歡迎的 Node.js 套件，XML2JS 使將 XML 數據轉換成 JavaScript 對象變得容易，從而促進程序化操作和使用 XML 材料。 相反，IronPDF 專精於從 HTML（包括動態創建的材料）生成高質量 PDF 文件，支持可調的頁面大小、頁邊距和頁眉。

開發人員現在可以通過 XML2JS 和 IronPDF 動態地直接從 XML 數據源創建 PDF 報告、發票或其他可打印材料。 為了自動化文件生成過程並確保在 Node.js 應用程序中管理基於 XML 的數據以輸出 PDF 的準確性和靈活性，此集成利用了兩個庫的優勢。

什麼是 xml2js？

一個名為 XML2JS 的 Node.js 套件可便於解析和創建簡單的 XML（可擴展標記語言）到 JavaScript 對象轉換器。 通過提供解析 XML 文件或文本並將其轉換成結構化 JavaScript 對象的方法，使得 XML 文檔的處理變得更容易。 此過程通過提供僅管理 XML 屬性、文本內容、命名空間、合併屬性或鍵屬性等 XML 特定特徵的選項，給予應用程序自由解釋和使用 XML 數據。

xml2js npm（開發者指南）: 圖1

該庫可以處理大型 XML 文檔或需要非阻塞解析的情況，因為它支持同步和異步解析操作。 此外，XML2JS 還提供了在將 XML 轉換為 JavaScript 對象期間的驗證和錯誤解決機制，以保證數據處理操作的穩定性和可靠性。 總而言之，Node.js 應用程序經常使用 XML2JS 來整合基於 XML 的數據源、配置軟件、改變數據格式以及簡化自動化測試過程。

由於具備以下特點，XML2JS 是一個在 Node.js 應用程序中處理 XML 數據的靈活和不可或缺的工具：

XML 解析

借助 XML2JS，開發人員可以更快速地使用著名的 JavaScript 語法訪問和處理 XML 數據，通過將 XML 字串或文件處理成 JavaScript 對象來簡化過程。

JavaScript 對象轉換

通過將 XML 數據平滑地轉換為結構化 JavaScript 對象，使在 JavaScript 應用程序內處理 XML 數據變得簡單。

可配置選項

XML2JS 提供了一系列配置選項，允許您更改 XML 數據的解析和轉換為 JavaScript 對象的方式。 這包括管理命名空間、文本內容、屬性和其他事項。

雙向轉換

通過其雙向轉換功能，使 JavaScript 對象轉換回簡單的 XML 字串成為可能，從而實現數據的往返更改。

異步解析

該庫支持異步解析過程，可以很好地處理大型 XML 文檔，不會干擾應用程序的事件循環。

錯誤處理

為了處理在 XML 解析和轉換過程中可能出現的驗證問題和解析錯誤，XML2JS 提供了強大的錯誤處理方法。

與 Promises 整合

它與 JavaScript Promises 協同工作，使處理 XML 數據的異步代碼模式更清晰易於處理。

可自定義解析勾住

開發人員可以通過創建自定義解析鉤子來增加數據處理過程的靈活性，從而使他們有特殊的選項來攔截和改變 XML 解析行為。

創建和配置 xml2js

在 Node.js 應用程序中使用 XML2JS 的第一步是安裝該庫並將其配置以滿足您的需求。 這是一個設定和創建 XML2JS 的詳細指南。

安裝 XML2JS npm

首先確保已經安裝了 npm 和 Node.js。可以使用 npm 安裝 XML2JS：

npm install xml2js
npm install xml2js
SHELL

XML2JS 的基本用法

這是一個簡單的例子，顯示了如何使用 XML2JS 將 XML 文本解析成 JavaScript 對象：

const xml2js = require('xml2js');

// Example XML content
const xmlContent = `
<bookstore>
  <book category="fiction">
    <title>Harry Potter</title>
    <author>J.K. Rowling</author>
  </book>
  <book category="nonfiction">
    <title>Thinking, Fast and Slow</title>
    <author>Daniel Kahneman</author>
  </book>
</bookstore>
`;

// Configure XML2JS parser
const parser = new xml2js.Parser();

// Parse XML content
parser.parseString(xmlContent, (err, result) => {
  if (err) {
    console.error('Error parsing XML:', err);
    return;
  }
  console.log('Parsed XML to JavaScript object:', result);
});
const xml2js = require('xml2js');

// Example XML content
const xmlContent = `
<bookstore>
  <book category="fiction">
    <title>Harry Potter</title>
    <author>J.K. Rowling</author>
  </book>
  <book category="nonfiction">
    <title>Thinking, Fast and Slow</title>
    <author>Daniel Kahneman</author>
  </book>
</bookstore>
`;

// Configure XML2JS parser
const parser = new xml2js.Parser();

// Parse XML content
parser.parseString(xmlContent, (err, result) => {
  if (err) {
    console.error('Error parsing XML:', err);
    return;
  }
  console.log('Parsed XML to JavaScript object:', result);
});
JAVASCRIPT

xml2js npm（開發者指南）: 圖2

配置選項

XML2JS 提供了一系列配置選項和默認設置，讓您更改解析行為。 這裡是一個設置 XML2JS 的默認解析設置的例子：

const xml2js = require('xml2js');

// Example XML content
const xmlContent = `
<bookstore>
  <book category="fiction">
    <title>Harry Potter</title>
    <author>J.K. Rowling</author>
  </book>
  <book category="nonfiction">
    <title>Thinking, Fast and Slow</title>
    <author>Daniel Kahneman</author>
  </book>
</bookstore>
`;

// Configure XML2JS parser with options
const parser = new xml2js.Parser({
  explicitArray: false,  // Converts child elements to objects instead of arrays when there is only one child
  trim: true  // Trims leading/trailing whitespace from text nodes
});

// Parse XML content
parser.parseString(xmlContent, (err, result) => {
  if (err) {
    console.error('Error parsing XML:', err);
    return;
  }
  console.log('Parsed XML to JavaScript object with options:', result);
});
const xml2js = require('xml2js');

// Example XML content
const xmlContent = `
<bookstore>
  <book category="fiction">
    <title>Harry Potter</title>
    <author>J.K. Rowling</author>
  </book>
  <book category="nonfiction">
    <title>Thinking, Fast and Slow</title>
    <author>Daniel Kahneman</author>
  </book>
</bookstore>
`;

// Configure XML2JS parser with options
const parser = new xml2js.Parser({
  explicitArray: false,  // Converts child elements to objects instead of arrays when there is only one child
  trim: true  // Trims leading/trailing whitespace from text nodes
});

// Parse XML content
parser.parseString(xmlContent, (err, result) => {
  if (err) {
    console.error('Error parsing XML:', err);
    return;
  }
  console.log('Parsed XML to JavaScript object with options:', result);
});
JAVASCRIPT

處理異步解析

XML2JS 支持異步解析，這對於在不停止事件循環的情況下管理大型 XML 文檔特別有用。這裡是如何使用 async/await 語法與 XML2JS 的例子：

const xml2js = require('xml2js');

// Example XML content (assume it's loaded asynchronously, e.g., from a file)
const xmlContent = `
<bookstore>
  <book category="fiction">
    <title>Harry Potter</title>
    <author>J.K. Rowling</author>
  </book>
  <book category="nonfiction">
    <title>Thinking, Fast and Slow</title>
    <author>Daniel Kahneman</author>
  </book>
</bookstore>
`;

// Configure XML2JS parser
const parser = new xml2js.Parser();

// Async function to parse XML content
async function parseXml(xmlContent) {
  try {
    const result = await parser.parseStringPromise(xmlContent);
    console.log('Parsed XML to JavaScript object (async):', result);
  } catch (err) {
    console.error('Error parsing XML (async):', err);
  }
}

// Call async function to parse XML content
parseXml(xmlContent);
const xml2js = require('xml2js');

// Example XML content (assume it's loaded asynchronously, e.g., from a file)
const xmlContent = `
<bookstore>
  <book category="fiction">
    <title>Harry Potter</title>
    <author>J.K. Rowling</author>
  </book>
  <book category="nonfiction">
    <title>Thinking, Fast and Slow</title>
    <author>Daniel Kahneman</author>
  </book>
</bookstore>
`;

// Configure XML2JS parser
const parser = new xml2js.Parser();

// Async function to parse XML content
async function parseXml(xmlContent) {
  try {
    const result = await parser.parseStringPromise(xmlContent);
    console.log('Parsed XML to JavaScript object (async):', result);
  } catch (err) {
    console.error('Error parsing XML (async):', err);
  }
}

// Call async function to parse XML content
parseXml(xmlContent);
JAVASCRIPT

入門指南

為了在 Node.js 應用程序中使用 IronPDF 和 XML2JS，您必須首先讀取 XML 數據，然後從處理過的內容創建 PDF 文件。 這是一個詳細的指南，將幫助您安裝和配置這些庫。

什麼是 IronPDF？

IronPDF 庫是一個強大的 Node.js 庫，用於處理 PDF。 它的目標是將 HTML 內容轉換為具有卓越質量的 PDF 文件。 它簡化了將 HTML、CSS 和其他 JavaScript 文件轉換為格式化良好的 PDF 的過程，且不損害原始的在線內容。 這是一個非常有用的工具，適用於需要生成動態、可打印文件的網頁應用，例如發票、證書和報告。

IronPDF 具有多種功能，包括可自定義的頁面設置、頁眉、頁腳以及插入字體和圖片的能力。 它支持複雜的佈局和樣式，以確保所有測試輸出的 PDF 都符合指定的設計。 此外，IronPDF 內部控制 JavaScript 執行，允許動態和交互式內容的準確渲染。

xml2js npm（開發者指南）: 圖3

IronPDF 的功能

從HTML生成PDF

將 HTML、CSS 和 JavaScript 轉換為 PDF。 支持兩個現代網絡標準：媒體查詢和響應式設計。 使用 HTML 和 CSS 動態裝飾 PDF 發票、報告和文件非常有用。

PDF編輯

可以在已有的PDF中添加文本、圖片和其他材料。 從PDF文件中提取文本和圖像。 將多個 PDF 合併為一個文件。將 PDF 文件分割成若干獨立文件。 添加頁眉、頁腳、注釋和水印。

性能和可靠性

在工業環境中，性能高和可靠性是理想的設計屬性。 易於處理大型文件集。

安裝 IronPDF

要獲得在 Node.js 專案中處理 PDF 的工具，請安裝 IronPDF 套件。

npm install @ironsoftware/ironpdf
npm install @ironsoftware/ironpdf
SHELL

解析 XML 並生成 PDF

舉例來說，讓我們生成一個名為 example.xml 的基本 XML 文件：

<!-- example.xml -->
<bookstore>
  <book category="fiction">
    <title>Harry Potter</title>
    <author>J.K. Rowling</author>
  </book>
  <book category="nonfiction">
    <title>Thinking, Fast and Slow</title>
    <author>Daniel Kahneman</author>
  </book>
</bookstore>
<!-- example.xml -->
<bookstore>
  <book category="fiction">
    <title>Harry Potter</title>
    <author>J.K. Rowling</author>
  </book>
  <book category="nonfiction">
    <title>Thinking, Fast and Slow</title>
    <author>Daniel Kahneman</author>
  </book>
</bookstore>
XML

創建 generatePdf.js Node.js 腳本，該腳本讀取 XML 文件，使用 XML2JS 解析為 JavaScript 對象，然後用 IronPDF 從生成的解析數據對象創建 PDF。

// generatePdf.js
const fs = require('fs');
const xml2js = require('xml2js');
const IronPdf = require('@ironsoftware/ironpdf');

// Configure IronPDF with license if necessary
var config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' });

// Function to read and parse XML
const parseXml = async (filePath) => {
  const parser = new xml2js.Parser();
  const xmlContent = fs.readFileSync(filePath, 'utf8');
  return await parser.parseStringPromise(xmlContent);
};

// Function to generate HTML content from the parsed object
function generateHtml(parsedXml) {
  let htmlContent = `
    <!DOCTYPE html>
    <html lang="en">
    <head>
      <meta charset="UTF-8">
      <title>Bookstore</title>
      <style>
        body { font-family: Arial, sans-serif; }
        .book { margin-bottom: 20px; }
      </style>
    </head>
    <body>
      <h1>Bookstore</h1>
  `;

  // Iterate over each book to append to the HTML content
  parsedXml.bookstore.book.forEach(book => {
    htmlContent += `
      <div class="book">
        <h2>${book.title}</h2>
        <p><strong>Category:</strong> ${book.$.category}</p>
        <p><strong>Author:</strong> ${book.author}</p>
      </div>
    `;
  });

  htmlContent += `
    </body>
    </html>
  `;
  return htmlContent;
}

// Main function to generate PDF
const generatePdf = async () => {
  try {
    const parser = await parseXml('./example.xml');
    const htmlContent = generateHtml(parser);

    // Convert HTML to PDF
    IronPdf.PdfDocument.fromHtml(htmlContent).then((pdfres) => {
      const filePath = `${Date.now()}.pdf`;
      pdfres.saveAs(filePath).then(() => {
        console.log('PDF saved successfully!');
      }).catch((e) => {
        console.log(e);
      });
    });
  } catch (error) {
    console.error('Error:', error);
  }
};

// Run the main function
generatePdf();
// generatePdf.js
const fs = require('fs');
const xml2js = require('xml2js');
const IronPdf = require('@ironsoftware/ironpdf');

// Configure IronPDF with license if necessary
var config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' });

// Function to read and parse XML
const parseXml = async (filePath) => {
  const parser = new xml2js.Parser();
  const xmlContent = fs.readFileSync(filePath, 'utf8');
  return await parser.parseStringPromise(xmlContent);
};

// Function to generate HTML content from the parsed object
function generateHtml(parsedXml) {
  let htmlContent = `
    <!DOCTYPE html>
    <html lang="en">
    <head>
      <meta charset="UTF-8">
      <title>Bookstore</title>
      <style>
        body { font-family: Arial, sans-serif; }
        .book { margin-bottom: 20px; }
      </style>
    </head>
    <body>
      <h1>Bookstore</h1>
  `;

  // Iterate over each book to append to the HTML content
  parsedXml.bookstore.book.forEach(book => {
    htmlContent += `
      <div class="book">
        <h2>${book.title}</h2>
        <p><strong>Category:</strong> ${book.$.category}</p>
        <p><strong>Author:</strong> ${book.author}</p>
      </div>
    `;
  });

  htmlContent += `
    </body>
    </html>
  `;
  return htmlContent;
}

// Main function to generate PDF
const generatePdf = async () => {
  try {
    const parser = await parseXml('./example.xml');
    const htmlContent = generateHtml(parser);

    // Convert HTML to PDF
    IronPdf.PdfDocument.fromHtml(htmlContent).then((pdfres) => {
      const filePath = `${Date.now()}.pdf`;
      pdfres.saveAs(filePath).then(() => {
        console.log('PDF saved successfully!');
      }).catch((e) => {
        console.log(e);
      });
    });
  } catch (error) {
    console.error('Error:', error);
  }
};

// Run the main function
generatePdf();
JAVASCRIPT

一個簡單的方法是將 IronPDF 和 XML2JS 結合在 Node.js 應用程序中，用於轉換 XML 數據並將多個文件解析成 PDF 文件。 使用 XML2JS，在首次使用 Node.js 的 fs 模塊讀取 XML 文件後，將多個文件的 XML 內容解析為 JavaScript 對象。 隨後，使用這些處理過的數據動態生成形成 PDF 基礎的 HTML 文本。

該腳本首先從文件中讀取 XML 文本，並使用 xml2js 將其解析為 JavaScript 對象。 從解析的數據對象中，將使用自定義函數創建 HTML 內容，並將其結構為所需元素——例如書店裡的作者和書名。 此 HTML 隨後使用 IronPDF 轉換為 PDF 緩衝區。 生成的 PDF 然後將被保存到文件系統。

xml2js npm（開發者指南）: 圖4

使用 IronPDF 有效的 HTML 到 PDF 轉換和 XML2JS 強大的 XML 解析功能，此方法提供了一種簡化的方式來從 XML 數據在 Node.js 應用程序中創建 PDF。 此連接使得可以將動態 XML 數據轉換為可打印和格式良好的 PDF 文件。 這使得它非常適合需要從 XML 資源自動生成文件的應用。

xml2js npm（開發者指南）: 圖5

結論

總而言之，XML2JS 和 IronPDF 在一個 Node.js 應用程序中一起提供了一種強大而靈活的方法來將 XML 數據轉換成高質量的 PDF 文件。 使用 XML2JS 有效地將 XML 解析為 JavaScript 對象，使數據抽取和操作變得簡單。 數據解析後，可以動態轉換為 HTML 文本，然後由 IronPDF 容易地轉換成格式良好的 PDF 文件。

這種組合對需要自動從 XML 數據源創建報告、發票和證書的應用程序尤其有用。 開發人員可以保證準確和具有美學吸引力的 PDF 輸出，精簡工作流程，且通過利用兩個庫的優勢提高 Node.js 應用程序的文檔生成能力。

IronPDF 為開發人員提供更多能力和更高效的開發，同時利用 Iron Software 的高度靈活的系統和套件。

當許可選項清晰且具體到項目時，開發人員更容易選擇最佳模型。 這些功能可讓開發人員以易於使用、高效且統一的方式解決多種問題。

Darrius Serrant
Darrius Serrant
  立即與工程團隊聊天
全棧軟件工程師 (WebOps)

Darrius Serrant 擁有邁阿密大學計算機科學學士學位，目前任職於 Iron Software 的全栈 WebOps 市場營銷工程師。從小就迷上編碼，他認為計算既神秘又可接近，是創意和解決問題的完美媒介。

在 Iron Software，Darrius 喜歡創造新事物，並簡化複雜概念以便於理解。作為我們的駐場開發者之一，他也自願教學生，分享他的專業知識給下一代。

對 Darrius 來說，工作令人滿意因為它被重視且有實際影響。

相關文章

30 天試用→完整產品。無限制。無需信用卡。 開始免費試用