Node.js PDF 程式庫

Name: IronPDF for Node.js
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 說明

Koa node js（開發者的使用方法）

Curtis Chau

Updated: 2026年6月20日

開發者可以通過將IronPDF（一個強大的PDF製作庫）與Koa JS（Node.js的現代輕量級網路和移動應用框架）結合起來，動態建立Node.js應用中的PDF文件。雖然IronPDF強大的功能使建立、編輯和操作PDF文件變得簡單，但Koa的簡單設計和異步函式的使用使其成為建立高效可擴展網路伺服器的絕佳選擇。

由於Koa的中介件架構，開發者可以輕鬆新增功能，如使用IronPDF進行PDF製作，並編寫乾淨且模塊化的程式碼。 Koa通過處理HTTP請求、使用路由器定義路由、發送文件和利用中介件函式，允許開發者在建立PDF文件之前請求和預處理資料。

將Koa的靈活性和簡單性與IronPDF的強大PDF文件建立能力相結合，開發者很快就能構建符合應用需求的動態和交互式PDF文件。無論是生成報告、發票還是文件，這一整合提供了改進Node.js應用中使用者體驗並加速文件流程的功能和資源。

Koa Node.js是什麼？

Koa.js是一個為Node.js開發的下一代網路框架，具有出色的異步函式支持，使開發者可以輕鬆編寫異步中介件。在根目錄運行npm init命令就可以啟動一個Koa項目，並隨著路由器的加入，使路由變得更加簡化和組織化。

由於Node.js的極簡網路框架，使用Koa.js建立在線應用和API變得更加容易和有趣。同樣是Express.js的開發團隊開發了Koa，通過利用異步函式（Promises，一個最近的JavaScript特徵）簡化了中介件組合和請求處理。

輕量且模塊化的架構是Koa的一大優勢。不同於將許多功能打包在一起的標準框架，Koa的精簡和專注核心使開發者可以通過中介件框架在需要時新增功能。由於模塊化設計保持了輕量級框架，應用的架構可能更靈活和可控。

Koa Node.js（開發者如何使用）：圖1 - Koa

極簡核心：Koa的核心緊湊且聚焦良好，只提供開發網路伺服器所需的功能。由於這種簡單設計，使框架輕量且可擴展，允許開發者在需要時通過中介件新增功能。

支持Async/Await：Koa主要依賴於異步函式或Promises，這些使同步程式碼和中介件的編寫變得更加便捷，同時保留了異步行為的優勢。這使得處理錯誤更簡單，並使異步編程更易讀。

模塊化中介件：通過Koa的中介件技術，開發者可以建立可重複使用的模塊化中介件函式，這些函式可以組合起來管理各種請求和響應體處理任務。預設情況下包含請求和響應物件及其他工具的上下文（ctx）物件對中介件函式是可存取的。

基於上下文的請求處理：在整個請求生命週期中，每個HTTP請求都會連接一個上下文物件（ctx物件），提供了一種便捷的方式來存取請求和響應資料以及工具。這種基於上下文物件的方法促進了更乾淨、更具表達性的程式碼，同時簡化了中介件開發過程。

錯誤處理：Koa預設包含用於處理錯誤的try/catch塊和錯誤事件監聽器。中介件函式可以檢測到錯誤處理，然後將消息發送到集中式中介件函式，產生更可靠和有組織的錯誤處理邏輯。

ES6+功能：為了建立一個更具表達性和簡潔的API來開發您的網路應用和伺服器，Koa利用了現代JavaScript功能，如生成器、async/await以及解構。這降低了模板程式碼的數量，並通過允許開發者編寫更清晰、易於理解的程式碼提高了開發效率。

廣泛的生態系統：Koa擁有一個強大、繁榮的第三方中介件框架和插件生態系統，擴展了其功能。由於有很多中介件選擇，開發者可以根據路由、身份驗證、日誌記錄等功能的獨特需求來定制其Koa應用。

建立和配置Koa Node.js

使用以下步驟在Node.js中構建和設置Koa.js應用：

安裝Koa

將Koa.js作為依賴項新增到您的項目中。執行以下命令：

npm install koa

npm install koa

SHELL

配置Koa

在您的app.js文件中配置新的Koa應用：

// Import Koa
const Koa = require('koa');

// Create a new Koa application instance
const app = new Koa();

// Define middleware function
app.use(async (ctx, next) => {
    // Log each incoming request
    console.log('Incoming request:', ctx.request.method, ctx.request.url);
    // Call the next middleware function
    await next();
});

// Define a route
app.use(async (ctx) => {
    // Set the response body
    ctx.body = 'Hello world!';
});

// Start the server
const port = process.env.PORT || 3000;
app.listen(port, () => {
    console.log(`Server listening on port ${port}`);
});

// Import Koa
const Koa = require('koa');

// Create a new Koa application instance
const app = new Koa();

// Define middleware function
app.use(async (ctx, next) => {
    // Log each incoming request
    console.log('Incoming request:', ctx.request.method, ctx.request.url);
    // Call the next middleware function
    await next();
});

// Define a route
app.use(async (ctx) => {
    // Set the response body
    ctx.body = 'Hello world!';
});

// Start the server
const port = process.env.PORT || 3000;
app.listen(port, () => {
    console.log(`Server listening on port ${port}`);
});

JavaScript

運行您的應用

保存更改後運行您的Koa應用：

node app.js

node app.js

SHELL

您的Koa伺服器現在已啟動並運行，準備接收請求。使用您的網路瀏覽器並轉到http://localhost:3000以存取它。

Koa Node.js（開發者如何使用）：圖2 - 應用運行輸出

從Postman工具的輸出。

Koa Node.js（開發者如何使用）：圖3 - Postman輸出

快速入門

設置Koa伺服器以處理流量並整合IronPDF安裝以建立動態PDF文件，是開始使用Koa.js和IronPDF的第一步。這是一個包含詳細說明的步驟指南。

什麼是IronPDF？

IronPDF是一個應用程式庫，旨在簡化PDF的建立、編輯和維護。使用此工具，開發者可以應用頁眉和水印，合併多個PDF文件，從HTML文件中提取文字和圖像，並執行許多其他任務。 IronPDF的詳細文件和使用者友好的API使開發者更容易處理PDF文件，自動建立高質量的PDF文件變得簡單。無論是建立發票、報告還是文件，IronPDF擁有增強文件工作流程和提供卓越使用者體驗所需的所有工具和功能，可以在各種情境中選擇使用。

Koa Node.js（開發者如何使用）：圖4 - IronPDF

IronPDF的功能

將HTML轉為PDF：輕鬆快速地將HTML素材（包含CSS和JavaScript）轉換為PDF文件。

PDF文件合併：將多個PDF合併為一個PDF文件，以簡化文件管理任務。

文字和圖像提取：從PDF文件中提取文字和圖像，以便用於進一步處理或資料分析。

水印應用：為PDF頁面應用文字或圖像水印，用於品牌標識或安全目的。

包含頁眉和頁腳：在PDF文件的頁眉和頁腳中包含自訂訊息或頁碼。

安裝IronPDF

使用Node包管理器安裝所需的Node.js套件以支持IronPDF功能。

> npm i @ironsoftware/ironpdf

npm i @ironsoftware/ironpdf

整合Koa與IronPDF

配置您的Koa應用並在app.js文件中包含IronPDF。

// Import Koa
const Koa = require('koa');
// Import IronPDF
const IronPdf = require('@ironsoftware/ironpdf');

const app = new Koa();
const document = IronPdf.PdfDocument;
const config = IronPdf.IronPdfGlobalConfig;

// Set the IronPDF configuration (e.g., license key)
config.setConfig({ licenseKey: '' }); 

// Define a route to generate PDF
app.use(async (ctx) => {
    try {
        // Generate PDF content from HTML
        const htmlContent = '<html><body><h1>Hello, IronPDF!</h1></body></html>';
        const pdf = await document.fromHtml(htmlContent);
        const pdfBuffer = await pdf.saveAsBuffer();
        
        // Set response headers
        ctx.set('Content-Type', 'application/pdf');
        ctx.body = pdfBuffer;
    } catch (error) {
        console.error('Error generating PDF:', error);
        // Handle errors during PDF generation
        ctx.status = 500;
        ctx.body = 'Internal Server Error';
    }
});

// Start the server
const port = process.env.PORT || 3000;
app.listen(port, () => {
    console.log(`Server running on port ${port}`);
});

// Import Koa
const Koa = require('koa');
// Import IronPDF
const IronPdf = require('@ironsoftware/ironpdf');

const app = new Koa();
const document = IronPdf.PdfDocument;
const config = IronPdf.IronPdfGlobalConfig;

// Set the IronPDF configuration (e.g., license key)
config.setConfig({ licenseKey: '' }); 

// Define a route to generate PDF
app.use(async (ctx) => {
    try {
        // Generate PDF content from HTML
        const htmlContent = '<html><body><h1>Hello, IronPDF!</h1></body></html>';
        const pdf = await document.fromHtml(htmlContent);
        const pdfBuffer = await pdf.saveAsBuffer();
        
        // Set response headers
        ctx.set('Content-Type', 'application/pdf');
        ctx.body = pdfBuffer;
    } catch (error) {
        console.error('Error generating PDF:', error);
        // Handle errors during PDF generation
        ctx.status = 500;
        ctx.body = 'Internal Server Error';
    }
});

// Start the server
const port = process.env.PORT || 3000;
app.listen(port, () => {
    console.log(`Server running on port ${port}`);
});

JavaScript

在這段程式碼中，Koa和IronPDF已被匯入我們的應用。我們利用Koa（一個輕量級的Node.js網路框架）來管理HTTP請求。 IronPDF是一個可以從HTML內容建立PDF文件的程式庫。使用app.use()在Koa應用中建立一個路由來處理所有進入的HTTP請求。

使用IronPDF，我們在路由處理程式中從HTML內容生成PDF（'<html><body><h1>Hello, IronPDF!</h1></body></html>'）。我們將響應主體設置為具有生成的PDF緩衝區的適當內容型別（application/pdf）。如果在建立PDF文件期間出現任何問題，我們將發布500內部伺服器錯誤狀態。

Koa Node.js（開發者如何使用）：圖5 - PDF輸出

結論

總而言之，在Node.js應用中結合Koa.js與IronPDF，提供了一種即時建立PDF文件的穩定方法。 Koa的異步中介件架構和簡單設計為管理HTTP請求和協調PDF建立工作流程提供了明確且可調整的框架。 IronPDF憑藉其全面的PDF生成和操作工具，能夠與Koa平滑整合，以便從HTML內容或其他來源建立高品質的PDF文件。

通過將IronPDF的強大功能與Koa的簡單性相結合，開發者能有效建立適合其個人需求的PDF文件應用。無論是產生報告、發票還是文件，開發者可以輕鬆通過此整合達成多種商業目標。

通過將IronPDF和Iron Software產品整合到您的開發堆中，您可以確保客戶及最終使用者接受到功能豐富的高端軟體解決方案。此外，這一穩固的基礎將有助於優化項目及流程。 IronPDF的定價始於$999。此工具完善的文件、活躍的線上開發者社區以及定期的升級使它成為現代軟體開發專案的合適選擇。