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 說明

Retry Node.js（開發者的使用方法）

Curtis Chau

Updated: 2026年4月23日

在Node.js中，"retry"（重試）一詞描述了由Node.js核心程式庫提供的模組，這個模組能使重試操作（在它們失敗後）變得更簡單。當處理網路請求或其他因暫時性問題如網路錯誤、伺服器宕機或超時而失敗的操作時，這個模組尤其有用。

重試模組提供了一個多功能且可配置的API，簡化了重試失敗任務的過程。它讓開發者可以指定重試行為和策略，例如重試次數、每次重試間的等待時間，以及重試應該發生的情況。

在動態的線上開發世界中，即時生成PDF是一個常見的需求。當涉及到建立發票、報告或證書時，Node.js開發者經常使用像IronPDF這樣的套件。

實際上，生成PDF的不成功嘗試可能源於網路問題、伺服器宕機或其他暫時性錯誤。在這些情況下，加入重試機制成為確保穩健性和可靠性的重要手段。在這篇文章中，我們探討了如何將User-Retry模式新增到IronPDF中，以幫助Node.js開發者改進PDF建立的可靠性。

理解User Retry模式

User-Retry模式是一種在軟體開發中用來處理操作期間可能出現的網路請求或遠程資源存取等暫時性問題的彈性技術。它也被稱作指數退避策略，或者重試時延遞增。這種模式對於分佈式系統尤為有效，因為多種因素比如網路問題、暫時性資源競爭、伺服器不可用或網路擁塞可能導致失敗。

如何運作User-Retry

第一次嘗試： 嘗試執行操作。如果成功，則照常繼續進行業務。如果程式因暫時錯誤失敗，則會啟用重試機制。
增加延遲的重試： 系統在重試失敗的操作之前暫停。每次重試嘗試都會增加隨後的嘗試之間的延遲。這種方法允許系統從暫時問題中恢復，而不過度消耗資源。
指數退避： 這種方法涉及每次重試嘗試之間的時間間隔以指數倍增加。例如，延遲可能從幾毫秒開始，並在每次重試嘗試時加倍。這種指數增長允許資源痊癒，防止系統因不斷重試而不堪重負。
最大重试次數： 重試過程將持續到操作成功或者達到最大重試次數。施加最大重試限制來避免過度要求和無限重試，防止資源耗盡或長時間停機。

使用User-Retry的好處

增強彈性： 使用User-Retry模式的系統對暫時性故障更有彈性，可以優雅地恢復而不需要人為介入。
減少資源負擔： 重試之間的較長時間間隔減少目標資源的負擔和失敗嘗試的次數，增強系統穩定性。
更快的恢復： 指數退避允許系統通過調整重試間隔更快速地從暫時性問題中恢復，提高成功重試的概率。
改善使用者體驗： 由於暫時錯誤的透明處理，使用者經歷較少的中斷和延遲，保持更無縫且可靠的使用者體驗。

在Node.js中建立和使用重試

重試模組是Node.js的主要模組之一，它簡化了在Node.js中重試任務的過程。這個模組使得處理網路請求或其他異步過程中可能發生的暫時故障變得更容易。以下是如何在Node.js中實現重試邏輯的詳細指南：

安裝Node.js

如果您尚未安裝Node.js，請從Node.js官方網站下載並安裝。

建立一個Node.js專案

為您的專案建立一個新目錄，並通過終端或命令提示符進入其中：

mkdir retry-example
cd retry-example

mkdir retry-example
cd retry-example

SHELL

通過初始化來設置一個新的Node.js專案：

npm init -y

npm init -y

SHELL

這將會在專案目錄中建立一個package.json文件。

安裝重試模組

注意：與原生Node.js不同，重試功能通常由像async-retry這樣的npm套件提供。

實現重試邏輯

以下是顯示如何使用async-retry模組構建重試邏輯的Node.js程式碼範例。在此範例中，進行了一次虛構的網路請求，如果由於暫時性問題失敗，將通過指數退避重試。

const retry = require('async-retry');

// Simulate a function that performs a network request with intermittent failures
function performNetworkRequest(callback) {
    // Simulate a network request that fails 50% of the time
    const isSuccess = Math.random() < 0.5;
    if (isSuccess) {
        callback(null, 'Request successful');
    } else {
        callback(new Error('Request failed'));
    }
}

// Define options for retrying the operation
const operationOptions = {
    retries: 3,             // Number of retry attempts
    factor: 2,              // Exponential backoff factor
    minTimeout: 1000,       // Initial retry delay in milliseconds
    maxTimeout: 60000,      // Maximum retry delay in milliseconds
    randomize: true         // Randomize retry delays
};

// Create a retry operation instance
const retryOperation = retry.operation(operationOptions);

// Execute the operation with retry logic
retryOperation.attempt(function(currentAttempt) {
    performNetworkRequest(function(err, result) {
        if (retryOperation.retry(err)) {
            // Retry the operation
            console.log(`Attempt ${currentAttempt}: Retrying operation...`);
            return;
        }
        // Operation succeeded or max retries reached
        if (err) {
            console.error('Operation failed after ' + currentAttempt + ' attempts:', err);
        } else {
            console.log('Operation succeeded:', result);
        }
    });
});

const retry = require('async-retry');

// Simulate a function that performs a network request with intermittent failures
function performNetworkRequest(callback) {
    // Simulate a network request that fails 50% of the time
    const isSuccess = Math.random() < 0.5;
    if (isSuccess) {
        callback(null, 'Request successful');
    } else {
        callback(new Error('Request failed'));
    }
}

// Define options for retrying the operation
const operationOptions = {
    retries: 3,             // Number of retry attempts
    factor: 2,              // Exponential backoff factor
    minTimeout: 1000,       // Initial retry delay in milliseconds
    maxTimeout: 60000,      // Maximum retry delay in milliseconds
    randomize: true         // Randomize retry delays
};

// Create a retry operation instance
const retryOperation = retry.operation(operationOptions);

// Execute the operation with retry logic
retryOperation.attempt(function(currentAttempt) {
    performNetworkRequest(function(err, result) {
        if (retryOperation.retry(err)) {
            // Retry the operation
            console.log(`Attempt ${currentAttempt}: Retrying operation...`);
            return;
        }
        // Operation succeeded or max retries reached
        if (err) {
            console.error('Operation failed after ' + currentAttempt + ' attempts:', err);
        } else {
            console.log('Operation succeeded:', result);
        }
    });
});

JavaScript

IronPDF整合

結合IronPDF與重試邏輯可在Node.js應用中進行可靠的PDF生成。

安裝IronPDF

首先，使用npm安裝IronPDF程式庫：

> npm i @ironsoftware/ironpdf

npm i @ironsoftware/ironpdf

導入和配置IronPDF

要使用IronPDF，首先需要導入並配置它（如果已購買）您的授權金鑰：

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

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

JavaScript

定義PDF生成函式

使用IronPDF建立一個函式來生成PDF：

async function generatePdf(htmlContent) {
    try {
        const pdf = await PdfDocument.fromHtml(htmlContent);
        return pdf;
    } catch (error) {
        // Log or handle the error
        console.error("Error occurred during PDF generation:", error);
        throw error;
    }
}

async function generatePdf(htmlContent) {
    try {
        const pdf = await PdfDocument.fromHtml(htmlContent);
        return pdf;
    } catch (error) {
        // Log or handle the error
        console.error("Error occurred during PDF generation:", error);
        throw error;
    }
}

JavaScript

為PDF生成實現重試邏輯

使用async-retry整合重試邏輯以處理PDF生成：

const retry = require('async-retry');

async function retryGeneratePdf(htmlContent) {
    return await retry(async (bail, attempt) => {
        console.log(`Attempt ${attempt} to generate PDF`);
        return await generatePdf(htmlContent);
    }, {
        retries: 3,          // Maximum number of retry attempts
        factor: 2,           // Exponential backoff factor
        minTimeout: 1000,    // Initial retry delay in milliseconds
        maxTimeout: 60000,   // Maximum retry delay in milliseconds
        randomize: true      // Randomize retry delays
    });
}

const retry = require('async-retry');

async function retryGeneratePdf(htmlContent) {
    return await retry(async (bail, attempt) => {
        console.log(`Attempt ${attempt} to generate PDF`);
        return await generatePdf(htmlContent);
    }, {
        retries: 3,          // Maximum number of retry attempts
        factor: 2,           // Exponential backoff factor
        minTimeout: 1000,    // Initial retry delay in milliseconds
        maxTimeout: 60000,   // Maximum retry delay in milliseconds
        randomize: true      // Randomize retry delays
    });
}

JavaScript

生成具有重試邏輯的PDF

您現在可以使用retryGeneratePdf函式建立具有重試邏輯的PDF：

const htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";

retryGeneratePdf(htmlContent)
    .then(pdf => {
        // PDF generation succeeded
        await pdf.saveAs('output.pdf');
        console.log("PDF generated successfully");
        // Handle the generated PDF
    })
    .catch(error => {
        // PDF generation failed after retries
        console.error("Failed to generate PDF:", error);
    });

const htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";

retryGeneratePdf(htmlContent)
    .then(pdf => {
        // PDF generation succeeded
        await pdf.saveAs('output.pdf');
        console.log("PDF generated successfully");
        // Handle the generated PDF
    })
    .catch(error => {
        // PDF generation failed after retries
        console.error("Failed to generate PDF:", error);
    });

JavaScript

自定義選項： 根據您的應用程式需求自定義重試策略和錯誤處理，並納入日志記錄以便監控和除錯。

結合IronPDF與重試邏輯，您可以提高Node.js應用中PDF生成的可靠性，並在過程中優雅地處理錯誤。

在 Retry Node.js (How It Works For Developers)：圖1