如何使用 Node.js 列印 PDF 檔案

可以設定哪些印表機選項？

printer選項s 物件支援以下欄位：

若文件需要在生成 PDF 時（而非列印時）套用自訂紙張尺寸或特定頁面方向，請在儲存檔案前，於 IronPDF 的渲染步驟中設定這些選項。

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能，例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic

Microsoft MVP

查看案例研究

IronOCR意味著我們每年可以從手動處理中節省$40,000，同時提高生產力，釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle

首席技術官，OPYN

查看案例研究

IronSuite在我們的運營中扮演著至關重要的角色。這些工具增加了包括建立平面圖和改善庫存管理在內的業務效率。

David Jones

首席軟體工程師，Agorus Build

查看案例研究

如何在 Node.js 中實作批次列印？

透過遍歷陣列並針對每個檔案呼叫 printer.print()，來處理一整夾層的 PDF 檔案或動態生成的清單。將 for...of 與 await 搭配使用，可確保工作依序執行，從而避免列印佇列因同時接收過多請求而超載。

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-print-pdf/batch-print.js
const printer = require('pdf-to-printer');
const fs = require('fs').promises;
const path = require('path');

class BatchPrinter {
  constructor(printerName = null) {
    this.printerName = printerName;
    this.queue = [];
  }

  async addFiles(filePaths) {
    for (const filePath of filePaths) {
      try {
        await fs.access(filePath);
        this.queue.push(filePath);
      } catch {
        console.warn(`Skipped (not found): ${filePath}`);
      }
    }
  }

  async printAll(options = {}) {
    const results = { successful: 0, failed: 0, errors: [] };

    for (const filePath of this.queue) {
      try {
        const printOptions = {
          ...options,
          ...(this.printerName && { printer: this.printerName }),
        };
        await printer.print(filePath, printOptions);
        results.successful++;
        console.log(`Printed: ${path.basename(filePath)}`);
      } catch (err) {
        results.failed++;
        results.errors.push({ file: filePath, error: err.message });
      }
    }

    this.queue = [];
    return results;
  }
}

// Usage: print monthly reports to a specific printer
(async () => {
  const batch = new BatchPrinter('Office Printer A3');

  await batch.addFiles([
    './reports/january.pdf',
    './reports/february.pdf',
    './reports/march.pdf',
  ]);

  const results = await batch.printAll({ copies: 1 });
  console.log(`Done -- ${results.successful} printed, ${results.failed} failed.`);
})();

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-print-pdf/batch-print.js
const printer = require('pdf-to-printer');
const fs = require('fs').promises;
const path = require('path');

class BatchPrinter {
  constructor(printerName = null) {
    this.printerName = printerName;
    this.queue = [];
  }

  async addFiles(filePaths) {
    for (const filePath of filePaths) {
      try {
        await fs.access(filePath);
        this.queue.push(filePath);
      } catch {
        console.warn(`Skipped (not found): ${filePath}`);
      }
    }
  }

  async printAll(options = {}) {
    const results = { successful: 0, failed: 0, errors: [] };

    for (const filePath of this.queue) {
      try {
        const printOptions = {
          ...options,
          ...(this.printerName && { printer: this.printerName }),
        };
        await printer.print(filePath, printOptions);
        results.successful++;
        console.log(`Printed: ${path.basename(filePath)}`);
      } catch (err) {
        results.failed++;
        results.errors.push({ file: filePath, error: err.message });
      }
    }

    this.queue = [];
    return results;
  }
}

// Usage: print monthly reports to a specific printer
(async () => {
  const batch = new BatchPrinter('Office Printer A3');

  await batch.addFiles([
    './reports/january.pdf',
    './reports/february.pdf',
    './reports/march.pdf',
  ]);

  const results = await batch.printAll({ copies: 1 });
  console.log(`Done -- ${results.successful} printed, ${results.failed} failed.`);
})();

BatchPrinter 類別將驗證與執行功能分離。 在 addFiles() 處理過程中，若檔案不存在則會跳過，以避免單一檔案缺失導致整個批次處理中止。 printAll() 方法會記錄每份檔案的錯誤，並返回一份摘要，該摘要可記錄於日誌或轉發至監控服務。

針對動態生成的報告，可將此模式與 IronPDF 的 HTML 字串轉 PDF 功能結合，以單一流程完成生成與列印。在處理大量列印批次前，建議套用 PDF 壓縮範例，以減少網路印表機的排程傳輸時間。

針對 Node.js PDF 列印，有哪些平台特定的考量因素？

pdf-to-printer 套件在各作業系統上會使用不同的系統指令。 理解底層運作機制有助於診斷特定平台的故障。

如何處理 PDF 列印時的安全性與權限設定？

處理敏感文件（如合約、財務紀錄、醫療表格）的生產級列印系統，需要具備存取控制與稽核追蹤功能。 追蹤誰在何時列印了什麼內容，是許多受監管產業的合規要求。

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-print-pdf/secure-print.js
const printer = require('pdf-to-printer');
const crypto = require('crypto');

class AuditedPrinter {
  constructor() {
    this.log = [];
  }

  async print(filePath, userId, options = {}) {
    const jobId = crypto.randomBytes(8).toString('hex');
    const entry = { jobId, userId, filePath, options, status: 'pending', startedAt: new Date().toISOString() };
    this.log.push(entry);

    try {
      await printer.print(filePath, options);
      entry.status = 'completed';
      entry.completedAt = new Date().toISOString();
      return { success: true, jobId };
    } catch (err) {
      entry.status = 'failed';
      entry.error = err.message;
      throw err;
    }
  }

  getLog(userId = null) {
    return userId ? this.log.filter((e) => e.userId === userId) : this.log;
  }
}

// Usage
const auditedPrinter = new AuditedPrinter();

(async () => {
  await auditedPrinter.print('./contracts/nda-2026.pdf', 'user-42', { copies: 1 });
  console.log('Audit log:', auditedPrinter.getLog('user-42'));
})();

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-print-pdf/secure-print.js
const printer = require('pdf-to-printer');
const crypto = require('crypto');

class AuditedPrinter {
  constructor() {
    this.log = [];
  }

  async print(filePath, userId, options = {}) {
    const jobId = crypto.randomBytes(8).toString('hex');
    const entry = { jobId, userId, filePath, options, status: 'pending', startedAt: new Date().toISOString() };
    this.log.push(entry);

    try {
      await printer.print(filePath, options);
      entry.status = 'completed';
      entry.completedAt = new Date().toISOString();
      return { success: true, jobId };
    } catch (err) {
      entry.status = 'failed';
      entry.error = err.message;
      throw err;
    }
  }

  getLog(userId = null) {
    return userId ? this.log.filter((e) => e.userId === userId) : this.log;
  }
}

// Usage
const auditedPrinter = new AuditedPrinter();

(async () => {
  await auditedPrinter.print('./contracts/nda-2026.pdf', 'user-42', { copies: 1 });
  console.log('Audit log:', auditedPrinter.getLog('user-42'));
})();

AuditedPrinter 類別會為每個 PRINT 請求指派一個唯一的作業 ID，並記錄使用者身分、檔案路徑及時間戳記。 將 this.log 儲存至資料庫或僅追加的日誌檔案中，即可將其轉化為持久的稽核紀錄。 對於包含個人識別資訊的文件，建議使用 IronPDF 的 PDF 加密功能，在檔案進入列印佇列前對靜態檔案進行保護。

對於透過 HTTP 接收列印請求的伺服器應用程式，請在列印前驗證檔案型別與大小——若上傳檔案非有效的 PDF 二進位檔，請予以拒絕。 切勿在未進行安全處理的情況下，將使用者提供的檔案路徑直接傳遞給 printer.print()。

[[n:(將稽核日誌儲存於應用程式可寫入目錄之外。 （具備檔案系統寫入權限的攻擊者不應能篡改PRINT記錄。）]])}]

Node.js PDF 列印的下一步是什麼？

本指南涵蓋了使用 pdf-to-printer 將現有 PDF 檔案印至本地及網路印表機的相關內容，範圍從基本的單一檔案列印，到批次列印佇列、自訂印表機選項、平台考量，以及受監管環境中的稽核記錄。

若要將此工作流程擴展至 PDF 生成，請開始試用 IronPDF for Node.js，並參照 HTML 轉 PDF 教學指南來建立端到端的文件處理流程。有關授權選項與批量定價，請參閱 IronPDF 授權頁面。

準備好深入探索了嗎？ 探索完整的 IronPDF for Node.js 教學系列，學習如何合併 PDF 檔案、壓縮 PDF 檔案，以及將 PDF 轉換為圖片。