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

在 Node.js 中列印 PDF 的先決條件有哪些？

using pdf-to-printer 之前，必須安裝 Node.js 14.x 或更新版本以及 npm。 此套件仰賴作業系統原生PRINT指令，而非內建的列印引擎，因此目標機器上必須已設定好印表機驅動程式。

在 Windows 系統上，此套件會透過 PowerShell 呼叫 SumatraPDF。 請確保您的系統政策不會阻擋 PowerShell 腳本的執行。 在 macOS 和 Linux 系統上，此套件會委派給 lp 指令，該指令是 CUPS 列印系統的一部分。 請確認已安裝 CUPS，且至少有一台印表機已註冊 lpstat -p。

如何設定 Node.js 專案以進行 PDF 列印？

在編寫任何列印邏輯之前，請先初始化新專案、安裝套件，並建立最基本的目錄結構。

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-print-pdf/setup.sh
mkdir pdf-printer
cd pdf-printer
npm init -y
npm install pdf-to-printer

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-print-pdf/setup.sh
mkdir pdf-printer
cd pdf-printer
npm init -y
npm install pdf-to-printer

安裝完成後，請建立一個名為 index.js 的檔案來存放您的列印邏輯，並建立一個名為 pdfs/ 的資料夾來存放您要列印的文件。 透過獨立的 config.js 區塊來處理印表機設定，可將印表機名稱與核心邏輯分離——這對於開發環境與生產環境的目標印表機不同的多環境部署而言，是一種實用的模式。

此模組採用在執行時解析的原生綁定，因此無需編譯步驟。 node_modules/pdf-to-printer/dist/ 目錄將包含針對偵測到的平台所預先編譯的二進位檔。

如何透過基本操作列印 PDF 檔案？

將絕對或相對檔案路徑傳遞給 printer.print()。 此方法會將文件排入系統預設印表機的佇列，並在列印工作被列印排程器接受時解決 Promise —— 而非在實際列印完成時。

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

async function printPDF(filePath) {
  // Verify the file exists before sending to printer
  await fs.access(filePath);

  const stats = await fs.stat(filePath);
  if (stats.size === 0) {
    throw new Error('PDF file is empty');
  }

  await printer.print(filePath);
  console.log(`Print job queued: ${filePath}`);
}

printPDF('./pdfs/invoice.pdf').catch((err) => {
  if (err.co/de === 'ENOENT') {
    console.error('File not found:', err.path);
  } else {
    console.error('Print error:', err.message);
  }
});

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

async function printPDF(filePath) {
  // Verify the file exists before sending to printer
  await fs.access(filePath);

  const stats = await fs.stat(filePath);
  if (stats.size === 0) {
    throw new Error('PDF file is empty');
  }

  await printer.print(filePath);
  console.log(`Print job queued: ${filePath}`);
}

printPDF('./pdfs/invoice.pdf').catch((err) => {
  if (err.co/de === 'ENOENT') {
    console.error('File not found:', err.path);
  } else {
    console.error('Print error:', err.message);
  }
});

在呼叫 printer.print() 之前檢查檔案是否存在，可避免因路徑錯誤或檔案已被移動而導致的隱性失敗。 若路徑無法解析，fs.access() 呼叫會拋出 ENOENT 錯誤，提供具描述性的錯誤訊息，而非一般的列印排程器拒絕訊息。 常見的錯誤原因包括相對路徑錯誤、缺少印表機驅動程式，以及印表機處於離線狀態。

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-print-pdf/generate-and-print.js
const { PdfDocument } = require('@ironsoftware/ironpdf');
const printer = require('pdf-to-printer');

async function generateAndPrint(htmlContent, outputPath) {
  // Render HTML to a PDF file using IronPDF
  const pdf = await PdfDocument.fromHtml(htmlContent);
  await pdf.saveAs(outputPath);

  // Send the generated file to the default printer
  await printer.print(outputPath);
  console.log(`Generated and printed: ${outputPath}`);
}

generateAndPrint('<h1>Monthly Report</h1><p>Sales data for May 2026.</p>', './pdfs/report.pdf');

//:path=/static-assets/pdf/content-code-examples/nodejs/how-to/nodejs-print-pdf/generate-and-print.js
const { PdfDocument } = require('@ironsoftware/ironpdf');
const printer = require('pdf-to-printer');

async function generateAndPrint(htmlContent, outputPath) {
  // Render HTML to a PDF file using IronPDF
  const pdf = await PdfDocument.fromHtml(htmlContent);
  await pdf.saveAs(outputPath);

  // Send the generated file to the default printer
  await printer.print(outputPath);
  console.log(`Generated and printed: ${outputPath}`);
}

generateAndPrint('<h1>Monthly Report</h1><p>Sales data for May 2026.</p>', './pdfs/report.pdf');

如何指定自訂印表機選項？

將 printer選項s 物件作為第二個參數傳遞給 printer.print()，以指定特定印表機、設定複印份數、選擇頁碼範圍或控制頁面縮放比例。 印表機名稱必須與 printer.getPrinters() 所回傳的值完全一致。

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

async function printWith選項s(filePath) {
  // List available printers to find the correct name
  const printers = await printer.getPrinters();
  printers.forEach((p) => {
    console.log(`${p.name} -- default: ${p.isDefault}`);
  });

  const options = {
    printer: 'HP LaserJet Pro',  // Exact name from getPrinters()
    copies: 2,                   // Number of copies
    pages: '1-3,5',              // Pages to print (optional)
    scale: 'fit',                // 'fit' | 'noscale' | 'shrink'
    orientation: 'portrait',     // 'portrait' | 'landscape'
  };

  await printer.print(filePath, options);
  console.log(`Printed ${options.co/pies} copies to "${options.printer}"`);
}

printWith選項s('./pdfs/shipping-label.pdf').catch(console.error);

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

async function printWith選項s(filePath) {
  // List available printers to find the correct name
  const printers = await printer.getPrinters();
  printers.forEach((p) => {
    console.log(`${p.name} -- default: ${p.isDefault}`);
  });

  const options = {
    printer: 'HP LaserJet Pro',  // Exact name from getPrinters()
    copies: 2,                   // Number of copies
    pages: '1-3,5',              // Pages to print (optional)
    scale: 'fit',                // 'fit' | 'noscale' | 'shrink'
    orientation: 'portrait',     // 'portrait' | 'landscape'
  };

  await printer.print(filePath, options);
  console.log(`Printed ${options.co/pies} copies to "${options.printer}"`);
}

printWith選項s('./pdfs/shipping-label.pdf').catch(console.error);

在 print() 之前呼叫 getPrinters() 有兩個目的：一是確認印表機已連線且可存取，二是取得作業系統用於路由列印工作所使用的權威名稱字串。 印表機名稱通常包含版本號或網路後綴，這些與系統設定中顯示的名稱可能有所不同。

如何在 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 print選項s = {
          ...options,
          ...(this.printerName && { printer: this.printerName }),
        };
        await printer.print(filePath, print選項s);
        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 print選項s = {
          ...options,
          ...(this.printerName && { printer: this.printerName }),
        };
        await printer.print(filePath, print選項s);
        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.com/pletedAt = 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.com/pletedAt = 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()。

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

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

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

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