Node.js PDF 程式庫

Name: IronPDF
Brand: Iron Software
Availability: InStock
Rating: 4.87 (307 reviews)

HTML 轉 PDF

import {PdfDocument} from "@ironsoftware/ironpdf";

(async () => {
    // Create a PDF from an HTML string
    const pdf = await PdfDocument.fromHtml("<h1>Hello World</h1>");

    // Export the PDF to a file
    await pdf.saveAs("output.pdf");

    // Advanced Example with HTML Assets
    // Load external HTML assets: Images, CSS, and JavaScript.
    const htmlContentWithAssets = "<img src='icons/iron.png'>";
    const advancedPdf = await PdfDocument.fromHtml(htmlContentWithAssets);

    // Save the PDF with loaded assets
    await advancedPdf.saveAs("html-with-assets.pdf");
})();

import {PdfDocument} from "@ironsoftware/ironpdf";

(async () => {
    // Create a PDF from an HTML string
    const pdf = await PdfDocument.fromHtml("<h1>Hello World</h1>");

    // Export the PDF to a file
    await pdf.saveAs("output.pdf");

    // Advanced Example with HTML Assets
    // Load external HTML assets: Images, CSS, and JavaScript.
    const htmlContentWithAssets = "<img src='icons/iron.png'>";
    const advancedPdf = await PdfDocument.fromHtml(htmlContentWithAssets);

    // Save the PDF with loaded assets
    await advancedPdf.saveAs("html-with-assets.pdf");
})();

NODE 說明

Axios Retry NPM（開發者的使用方法）

Curtis Chau

Updated: 2026年4月21日

在當今快速變化的數位環境中，網頁應用程式常常依賴多個外部服務、API和資源來為使用者提供動態資訊和功能。然而，有時這些依賴性會造成問題，例如超時、網路錯誤中斷和臨時故障，這可能會中止像PDF建立這樣的重要過程。為了確保應用程式的可靠性並優雅地處理這種情況，開發者們採用了強大的重試機制。

Axios Retry 是一個強大的npm庫，它簡化了為失敗的HTTP請求建立自定義重試邏輯。基於受歡迎的Node.js HTTP客戶端Axios之上，開發者可以通過結合Axios Retry（一個Axios插件）與IronPDF這個功能豐富的庫來設計堅固且具備容錯能力的PDF生成工作流程，以在Node.js應用程式中建立PDF文件。

這篇文章將討論將Axios Retry與IronPDF結合的好處，並展示這兩個工具如何一起工作以增強Node.js應用程式的PDF生成能力。通過將Axios Retry的彈性重試機制與IronPDF的先進PDF建立功能整合在一起，開發者可以確保PDF生成任務在面對暫時的網路中斷、冪等請求失敗或外部服務中斷時仍能可靠地執行。

重試邏輯

對於Axios請求，Axios-retry簡化了重試邏輯的實施。基於可編程的參數，如HTTP狀態碼或特定錯誤型別，它會自動重試不成功的請求。

自訂重試策略

為了調節重試請求的頻率和方法，開發者可以建立自訂重試策略。這涉及到定義最多重試次數、重試間隔和需要重試的情況。

指數回退

Axios-retry促進了一種流行的重試策略，稱為指數回退，其增量增加重試之間的間隔。這有助於提高失敗請求的成功機率，並避免用重複查詢壓垮伺服器。

可重試錯誤

開發者可以指定哪些錯誤型別或HTTP狀態碼應觸發重試。這允許精確控制哪些錯誤被視為永久性故障與應重試的錯誤。

重試截取器

Axios-retry提供了截取器，允許開發者按每個請求修改重試行為。這包括處理可重試錯誤、追踪重試嘗試和調整重試延遲。

全域配置

使用axios-retry，開發者可以為所有Axios請求全域設置重試策略，以確保整個應用程式請求生命周期的一致重試行為。

建立和配置Axios Retry

以下範例程式碼展示了如何在Node.js應用程式中利用Axios Retry，每一步都有簡單說明：

導入依賴

要為Axios新增重試功能，我們首先導入axios庫。

const axios = require('axios');
const axiosRetry = require('axios-retry');

const axios = require('axios');
const axiosRetry = require('axios-retry');

JavaScript

建立Axios實例

我們使用axios.create()來建立一個Axios實例，允許我們針對特定使用案例自訂Axios的行為。
要配置Axios Retry，我們調用axiosRetry()並傳入Axios實例和選項物件。選項物件的參數包括重試次數（retryCondition）。

// Create an Axios instance
const axiosInstance = axios.create();

// Create an Axios instance
const axiosInstance = axios.create();

JavaScript

配置重試

指定重試嘗試的次數。retryDelay 使用指數回退策略，隨著每次嘗試延遲指數增加。在此範例中，我們設置了3次重試。

axiosRetry(axiosInstance, {
    retries: 3, // Number of retry attempts
    retryDelay: axiosRetry.exponentialDelay, // Exponential delay function
    retryCondition: (error) => {
        // Retry on network errors or status code 429 (rate limit)
        return axiosRetry.isNetworkOrIdempotentRequestError(error) || error.response.status === 429;
    }
});

axiosRetry(axiosInstance, {
    retries: 3, // Number of retry attempts
    retryDelay: axiosRetry.exponentialDelay, // Exponential delay function
    retryCondition: (error) => {
        // Retry on network errors or status code 429 (rate limit)
        return axiosRetry.isNetworkOrIdempotentRequestError(error) || error.response.status === 429;
    }
});

JavaScript

開始使用IronPDF

什麼是IronPDF？

IronPDF Node.js Toolkit 是一個廣泛使用的庫，用於在應用程式中建立、編輯和渲染PDF文件。它提供了多種處理PDF的方式，包括在文件中插入文字、圖片及形狀，從現有PDF中提取內容及將HTML轉換為PDF。

IronPDF的主要優勢包括易用性、高效性和高速性——允許開發者快速生成高品質的PDF。

IronPDF的一些優點：

將HTML、圖像和原始資料轉換為PDF。
從PDF中提取文字和圖片。
新增標頭、頁尾和浮水印到PDF中。
加密和設置密碼保護PDF。
填寫和電子簽名文件。

安裝庫

將所需庫安裝並配置Axios以具備重試功能，是在Node.js應用程式中整合Axios Retry和IronPDF來生成PDF的第一步。以下是逐步指南：

npm install axios 
npm install axios-retry 
npm install ironpdf

npm install axios 
npm install axios-retry 
npm install ironpdf

SHELL

使用Axios Retry和IronPDF進行URL到PDF轉換

考慮這種情境：一個Node.js應用程式使用來自外部API的動態HTML內容IronPDF URL to PDF Example來生成PDF報告。應用程式應優雅地處理潛在的網路錯誤或速率限制，以確保涉及PDF建立的任務成功完成。

設置具有Axios Retry配置的Axios實例：

const axios = require('axios');
const axiosRetry = require('axios-retry');

// Create Axios instance
const axiosInstance = axios.create();

// Configure Axios Retry
axiosRetry(axiosInstance, {
    retries: 3,
    retryDelay: axiosRetry.exponentialDelay,
    retryCondition: (error) => {
        // Retry on network errors or status code 429 (rate limit)
        return axiosRetry.isNetworkOrIdempotentRequestError(error) || error.response.status === 429;
    }
});

const axios = require('axios');
const axiosRetry = require('axios-retry');

// Create Axios instance
const axiosInstance = axios.create();

// Configure Axios Retry
axiosRetry(axiosInstance, {
    retries: 3,
    retryDelay: axiosRetry.exponentialDelay,
    retryCondition: (error) => {
        // Retry on network errors or status code 429 (rate limit)
        return axiosRetry.isNetworkOrIdempotentRequestError(error) || error.response.status === 429;
    }
});

JavaScript

為了從HTML內容生成PDF文件，用您的授權金鑰初始化IronPDF：

const IronPdf = require("@ironsoftware/ironpdf");
var config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' });
const document = IronPdf.PdfDocument;

const IronPdf = require("@ironsoftware/ironpdf");
var config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' });
const document = IronPdf.PdfDocument;

JavaScript

現在，使用配置好的Axios實例從外部API檢索HTML內容並用IronPDF生成PDF文件：

(async () => {
    try {
        // Fetch HTML content using Axios
        const response = await axiosInstance.get('https://api.example.com/data');
        const htmlContent = response.data;
        
        // Generate PDF from HTML content using IronPDF
        const pdf = await document.fromHtml(htmlContent);
        await pdf.saveAs("output.pdf");

    } catch (error) {
        console.error('Error fetching HTML content:', error.message);
    }
})();

(async () => {
    try {
        // Fetch HTML content using Axios
        const response = await axiosInstance.get('https://api.example.com/data');
        const htmlContent = response.data;
        
        // Generate PDF from HTML content using IronPDF
        const pdf = await document.fromHtml(htmlContent);
        await pdf.saveAs("output.pdf");

    } catch (error) {
        console.error('Error fetching HTML content:', error.message);
    }
})();

JavaScript

根據應用程式的需求自訂重試選項、PDF建立和錯誤處理。徹底測試整合以確保可靠性和功能性。

通過結合使用Axios Retry和IronPDF這些技術，您可以在您的Node.js應用程式中可靠地處理HTTP請求重試並生成PDF文件。這種組合提供了可以承受網路錯誤和服務中斷的可靠工作流程以進行PDF生產。

以下是上述過程的輸出範例：

Axios Retry NPM（它如何為開發者工作）：圖1 - URL到PDF的輸出，帶有重試請求

結論

總而言之，在Node.js應用程式中結合使用Axios Retry和IronPDF，提供了解決HTTP請求重試和生成PDF文件的穩健可靠方法。通過利用Axios Retry的功能，開發者可以增強HTTP請求流程的彈性和穩定性，確保優雅地處理暫時的網路問題、伺服器錯誤或速率限制條件。

整體而言，Axios Retry和IronPDF共同為構建需要穩定PDF生成和HTTP請求處理的可擴展耐用的Node.js應用程式提供了一個強大的工具包。通過實施這些庫，開發者可以減輕臨時故障和網路中斷的影響，確保高品質PDF文件的常規交付，從而提高應用程式的可靠性和使用者體驗。

IronPDF的包中包括了以具競爭力的價格提供的終身授權。最低只需$999，提供了極具價值的價格。授權持有人可獲得24/7的線上工程支援。欲了解更多詳情，請存取IronPDF Licensing Page。在Iron Software Product Overview中探索有關Iron Software產品的更多資訊。