1. IronPDF for Node.js
  2. IronPDF for Node.js 部落格
  3. 節點幫助
  4. 重試 Node.js
節點幫助

重試 Node.js（開發人員的運作方式）

發佈 2024年6月6日
分享:

“重試”一詞在Node.js描述了一個由 Node.js 核心庫提供的模組，使重試失敗的操作變得更容易。 在處理網路請求或由於臨時故障（如網路錯誤、問題、伺服器中斷或超時）可能失敗的任何其他操作時，該模組尤其有用。

重試模組提供了多樣且可配置的API，使重新嘗試未成功任務的過程變得更加容易。 它允許開發人員指定重試行為和策略，例如嘗試次數、每次嘗試之間的間隔時間，以及重試應該發生的情況。

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

然而，在實際情況中，生成 PDF 的嘗試不成功可能由於網絡問題、伺服器故障或其他臨時錯誤所致。 在這些情況下，加入重試方法變得至關重要，以保證健壯性和可靠性。 在本文中，我們探討如何將 User-Retry 模式添加到 IronPDF，可以幫助 Node.js 開發人員提高 PDF 創建的可靠性。

了解使用者重試模式

用戶重試模式是在軟體開發中用來處理運行過程中可能出現的暫時性問題的一種韌性技術，例如網路請求或訪問遠程資源。 這也被稱為指數退避策略，或以增加延遲的重試。 此模式對於分佈式系統特別有幫助，因為許多因素，例如網絡問題如瞬時資源競爭、服務器無法應答數據或網絡擁堵，可能導致故障。

用戶重試的運作方式

第一次嘗試： 嘗試執行操作。 如果成功，業務將正常運作。 另一方面，如果程序因临时错误而失败，将激活重试机制。

重試並增加延遲： 系統會在嘗試再次執行未成功的操作前暫停一段時間，而不是立即重試。 每次嘗試重試時，重試延遲通常會變長。 這種延遲減少了過度消耗資源的可能性，並使系統能從暫時性問題中恢復。

指数退避： 這種方法，每次重試嘗試之間的間隔時間隨著每次嘗試呈指數增加，是計算重試延遲的流行方法。 例如，延遲可能從幾毫秒開始，並且每次重試時增加兩毫秒。 這種指數成長允許資源復原，並防止系統不斷地對其進行撞擊。

最大重試次數： 直到操作成功或達到最大重試次數為止，重試程序會繼續執行。 透過設置最大重試限制，例如，您可以防止系統發送過多的請求並無限重試，否則可能會導致資源耗盡或長時間停機。

使用使用者重試的好處

增強的彈性：當使用者重試模式被使用時，系統對臨時錯誤的抵抗力會更強。 他們不需要人力協助即可優雅地從挫折中恢復。

減少重試實施負擔：透過延長重試間隔時間，可以減輕對目標資源的負擔，並減少系統失敗的嘗試次數。 這提高了系統的整體穩定性，減少了級聯故障的可能性。

更快的恢復： 通過逐漸改變重試間隔，指數退避使系統能夠更快地從暫時的問題中恢復。 由於間隔時間較長，成功重試的機率增加，從而導致更快的恢復結果。

改進的使用者體驗： 在使用應用程式時，使用者如果使用用戶重試功能，將遇到更少的障礙和延遲。 通過透明管理臨時故障，系統維持更無縫且可靠的用戶體驗。

在 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
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'mkdir retry-example cd retry-example
VB   C#

通過執行以下操作設置一個全新的Node.JSON專案：

npm init -y
npm init -y
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'npm init -y
VB   C#

這將導致生成一個包。 在專案目錄中有一個 JSON 文件。

安裝重試模組

不需要單獨安裝重試模組，因為它已包含在 Node.JS 的核心庫中。

實現重試邏輯

以下是一個範例 Node.js 程式碼的實作示例，展示如何使用重試模組來建立重試邏輯。 在此示例程式碼中，進行了一個等待時間的 API 調用，如果因暫時性錯誤而失敗，則使用指數退避進行重試。

const retry = require('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 success = Math.random() < 0.5;
    if (success) {
        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('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 success = Math.random() < 0.5;
    if (success) {
        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);
        }
    });
});
Private const retry = require( 'retry');
' Simulate a function that performs a network request with intermittent failures
Private Function performNetworkRequest(ByVal As callback) As [function]
	' Simulate a network request that fails 50% of the time
	const success = Math.random() < 0.5
	If success Then
		callback(Nothing, 'Request successful');
	Else
		callback(New [Error]( 'Request failed'));
	End If
End Function
' Define options for retrying the operation
Private const operationOptions = { retries: 3, factor: 2, minTimeout: 1000, maxTimeout: 60000, randomize: True }
' Create a retry operation instance
Private const retryOperation = retry.operation(operationOptions)
' Execute the operation with retry logic
retryOperation.attempt([function](currentAttempt) { performNetworkRequest([function](err, result) { if(retryOperation.retry(err)) { console.log(`Attempt ${currentAttempt}:= Retrying operation...`); Return; } if(err) { console.error( 'Operation failed after ' + currentAttempt + ' attempts:', err); } else { console.log('Operation succeeded:', result); } }); });
VB   C#

要使用文件的功能，我們必須在開頭包含重試模組。 一個名為 performNetworkRequest 的模擬函式模擬了一個網路請求。它隨機失敗的機率為 50%。 重試操作的選項包含在 operationOptions 中。 我們指定最大和最小重試延遲、重試次數、指數退避因子，以及是否隨機化重試延遲。

使用 retry.operation()，我們建立一個重試操作的實例並提供 operationOptions。 我們在重試操作的嘗試回調中使用 performNetworkRequest 方法。 如果請求失敗且可重試，我們將重試該操作。(如retryOperation.retry所示(錯誤)). 如果 retryoperation 對象具有重試行為，我們將管理操作的成功或失敗。

入門

在 Python 網頁應用程式中製作 PDF 文件時，結合 IronPDF 和 Celery 可以非常有效。雖然 Celery 是一個分佈式任務佇列，可讓您將耗時的任務從網頁應用程式卸載到不同的工作程序，IronPDF 提供了創建、編輯和輸出 PDF 文件的能力。 通過異步創建PDF，IronPDF與Celery的集成有助於提高應用程式的可擴展性和性能。

什麼是 IronPDF？

我們可以使用熱門的 IronPDF，在應用程式內創建、修改和呈現 PDF 文件。IronPDF Node.js 函式庫. 處理 PDF 可以通過多種方式來完成：您可以從 HTML 內容、照片或原始數據創建新的 PDF 文檔； 您還可以將文字、圖像和形狀添加到現有的，從預先存在的文件中提取文字和圖像，並將HTML頁面轉換為PDF。

IronPDF 的簡單性和易用性是其主要優勢之一。 憑藉其用戶友好的 API 和豐富的文檔，開發人員可以快速開始從他們的 Node.js JS 應用程式中生成 PDF。IronPDF 的效率和速度是協助開發人員快速創建高品質 PDF 文件的另外兩個特點。

IronPDF 的幾個優勢：

  • 從 HTML、圖片和原始資料生成 PDF。
  • 從 PDF 文件中移除文字和圖片。
  • 在 PDF 文件中添加頁首、頁尾和浮水印。
  • 密碼和加密用於保護 PDF 文件。
  • 以電子方式完成和簽署文件的能力。

安裝 IronPDF

使用 pip 安裝 IronPDF 庫是第一步。

npm i @ironsoftware/ironpdf
npm i @ironsoftware/ironpdf
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'npm i @ironsoftware/ironpdf
VB   C#

導入和配置 IronPDF

IronPDF 程式庫安裝必須先使用 npm 進行。 在使用IronPDF進行PDF生成之前，您必須使用您的授權金鑰初始化它。 確保您已準備好您的IronPDF授權密鑰。

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

定義 PDF 生成功能

然後，使用 IronPDF 定義一個生成 PDF 的函數。 創建 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;
    }
}
Async Function generatePdf(ByVal As htmlContent) As [function]
	Try
		const pdf = Await PdfDocument.fromHtml(htmlContent)
		Return pdf
	Catch e1 As [error]
		' Log or handle the error
		console.error("Error occurred during PDF generation:", [error])
		Throw [error]
	End Try
End Function
VB   C#

實現重試邏輯

現在，加入重試邏輯以重試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
    });
}
Private const retry = require( 'async-retry');
Async Function retryGeneratePdf(ByVal As htmlContent) As [function]
	Return Await retry(Async Function(bail, attempt)
		console.log(`Attempt ${attempt} [to] generate PDF`)
		Return Await generatePdf(htmlContent)
	End Function,{
		retries:=3,
		factor:= 2,
		minTimeout:= 1000,
		maxTimeout:= 60000,
		randomize:= True
	})
End Function
VB   C#

生成具有重試邏輯的 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);
    });
Private const htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>"
'INSTANT VB WARNING: The following constructor is declared outside of its associated class:
'ORIGINAL LINE: retryGeneratePdf(htmlContent).then(pdf =>
Private Sub New()
	Await pdf.saveAs( 'output.pdf') console.log("PDF generated successfully");
End Sub
'INSTANT VB TODO TASK: Lambda expressions and anonymous methods are not converted by Instant VB if local variables of the outer method are referenced within the anonymous method:
).catch([error] =>
VB   C#

自訂重試邏輯： 您可以更改重試策略或在重試邏輯中處理特定問題以符合您的需求。

錯誤處理： 為了處理在創建PDF或重試期間出現的錯誤，請實施適當的錯誤處理。

日誌記錄： 包含日誌記錄，以追蹤錯誤和重試，方便監控和調試。

通過將 IronPDF 與重試邏輯集成到您的 Node.js 應用程式中，您可以提高可靠性並優雅地處理 PDF 創建錯誤。

重试 Node.js（開發人員的工作方式）：圖 1

結論

總而言之，將 IronPDF 與 Node.js 中的重試邏輯結合在一起，為在線應用程式提供了一種穩固且可靠的 PDF 生成方式。通過使用像 async-retry 這樣的庫以及 IronPDF 強大的 PDF 創建和操作功能，開發人員可以確保涉及 PDF 生成的過程能夠抵抗臨時錯誤和網絡問題。

當 IronPDF 與重試邏輯結合使用時，應用程式可以在 PDF 生成過程中發生故障時，自動以逐漸增加的延遲重新嘗試操作，優雅地容忍失敗。 這增加了即使在網絡狀況不佳或流量高的情況下，PDF創建任務也能有效完成的可能性。

IronPDF 以包含终身许可证的套件形式提供，价格实惠。 該套件性價比極高，僅售 749 美元，可適用於多個系統。 它為持牌者提供全天候的在線工程支持。 請訪問定價資訊頁面以瞭解更多關於該收費的資訊。 參觀Iron Software了解有關 Iron Software 產品的更多資訊。

< 上一頁
Axios重试NPM（開發者如何使用）
下一個 >
JavaScript 等待5秒（開發人員如何使用）

使用 npm 安裝

版本：2024.11

> npm i @ironsoftware/ironpdf

報告問題

準備開始了嗎？ 版本: 2024.11 剛剛發布

免費 npm 安裝 查看許可證 >