Wie druckt man PDF-Dateien mit Node.js

Was sind die Voraussetzungen zum Drucken von PDFs in Node.js?

Node.js 14.x oder höher und npm sind erforderlich, bevor pdf-to-printer verwendet werden kann. Das Paket stützt sich auf native OS-Druckbefehle anstelle eines gebündelten Druckmotors, sodass Druckertreiber bereits auf dem Zielrechner konfiguriert sein müssen.

Auf Windows ruft das Paket SumatraPDF über PowerShell auf. Stellen Sie sicher, dass die Ausführung von PowerShell-Skripten nicht durch Ihre Systemrichtlinie blockiert wird. Unter macOS und Linux delegiert das Paket an den Befehl lp, der Teil des CUPS-Drucksystems ist. Stellen Sie sicher, dass CUPS installiert ist und dass mindestens ein Drucker unter lpstat -p registriert ist.

Wie richtet man ein Node.js-Projekt zum Drucken von PDF ein?

Initialisieren Sie ein neues Projekt, installieren Sie das Paket und erstellen Sie eine minimale Verzeichnisstruktur, bevor Sie irgendeine Drucklogik schreiben.

//: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

Erstellen Sie nach der Installation eine index.js-Datei für Ihre Drucklogik und einen pdfs/-Ordner, in dem die zu druckenden Dokumente gespeichert werden. Ein separater config.js für Druckereinstellungen hält Druckernamen aus Ihrer Kernlogik heraus – ein nützliches Muster für Bereitstellungen in mehreren Umgebungen, in denen sich der Zieldrucker zwischen Entwicklung und Produktion unterscheidet.

Das Modul verwendet native Bindungen, die zur Laufzeit aufgelöst werden, sodass kein Kompilierungsschritt erforderlich ist. Das Verzeichnis node_modules/pdf-to-printer/dist/ enthält vorgefertigte Binärdateien für die erkannte Plattform.

Wie druckt man eine PDF-Datei mit grundlegender Verwendung?

Übergeben Sie den absoluten oder relativen Dateipfad an printer.print(). Die Methode stellt das Dokument mit dem Standarddrucker des Systems in die Warteschlange und löst das Promise auf, sobald der Auftrag vom Spooler akzeptiert wird — nicht, wenn das physische Drucken abgeschlossen ist.

//: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.code === '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.code === 'ENOENT') {
    console.error('File not found:', err.path);
  } else {
    console.error('Print error:', err.message);
  }
});

Das Überprüfen der Dateiexistenz vor dem Aufruf von printer.print() verhindert stillschweigende Fehler, wenn ein Pfad falsch ist oder eine Datei verschoben wurde. Der Aufruf fs.access() löst ENOENT aus, wenn der Pfad nicht aufgelöst werden kann, wodurch Sie eine aussagekräftige Fehlermeldung anstelle einer generischen Spooler-Ablehnung erhalten. Häufige Fehlerursachen sind falsche relative Pfade, fehlende Druckertreiber und offline Druckerstatus.

//: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');

Wie lege ich benutzerdefinierte Druckeroptionen fest?

Übergeben Sie ein printerOptions-Objekt als zweites Argument an printer.print(), um einen bestimmten Drucker anzusteuern, die Anzahl der Kopien festzulegen, Seitenbereiche auszuwählen oder die Seitenvergrößerung zu steuern. Der Druckername muss genau mit dem von printer.getPrinters() zurückgegebenen Wert übereinstimmen.

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

async function printWithOptions(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.copies} copies to "${options.printer}"`);
}

printWithOptions('./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 printWithOptions(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.copies} copies to "${options.printer}"`);
}

printWithOptions('./pdfs/shipping-label.pdf').catch(console.error);

Der Aufruf von getPrinters() vor print() dient zwei Zwecken: Er bestätigt, dass der Drucker online und erreichbar ist, und liefert Ihnen die autoritative Namenszeichenfolge, die das Betriebssystem zur Weiterleitung von Druckaufträgen verwendet. Druckernamen enthalten oft Versionsnummern oder Netzwerksuffixe, die sich von den im System gezeigten Namen unterscheiden.

Wie kann ich Batch-Druck in Node.js implementieren?

Verarbeiten Sie einen Ordner mit PDF-Dateien oder eine dynamisch generierte Liste, indem Sie ein Array durchlaufen und für jede Datei printer.print() aufrufen. Die Verwendung von for...of zusammen mit await sorgt für eine sequenzielle Abarbeitung der Aufträge, wodurch verhindert wird, dass der Druckspooler durch gleichzeitige Anfragen überlastet wird.

//: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.`);
})();

Die Klasse BatchPrinter trennt die Validierung von der Ausführung. Dateien, die nicht vorhanden sind, werden während addFiles() übersprungen, damit eine einzelne fehlende Datei nicht den gesamten Stapel abbricht. Die printAll()-Methode protokolliert Fehler pro Datei und gibt eine Zusammenfassung zurück, die protokolliert oder an einen Überwachungsdienst weitergeleitet werden kann.

Für dynamisch generierte Berichte kombinieren Sie dieses Muster mit der HTML-zu-PDF-Umwandlung von IronPDF, um in einer einzigen Pipeline zu generieren und zu drucken. Das PDF-Komprimierungsbeispiel ist es wert, vor großen Druckserien angewendet zu werden, um die Übertragungszeit des Spoilers bei Netzwerkdruckern zu reduzieren.

Was sind die plattformspezifischen Überlegungen for Node.js PDF-Druck?

Das pdf-to-printer-Paket verwendet auf jedem Betriebssystem unterschiedliche Systembefehle. Das Verständnis des zugrunde liegenden Mechanismus hilft bei der Diagnose plattformspezifischer Ausfälle.

Wie gehe ich mit Sicherheit und Berechtigungen beim Drucken von PDFs um?

Produktionsdrucksysteme, die sensible Dokumente - Verträge, Finanzaufzeichnungen, medizinische Formulare - verarbeiten, benötigen Zugriffskontrollen und Prüfpfade. Es ist in vielen regulierten Branchen eine Compliance-Anforderung, nachzuvollziehen, wer was und wann gedruckt hat.

//: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'));
})();

Die Klasse AuditedPrinter weist jeder PRINT-Anforderung eine eindeutige Auftrags-ID zu und protokolliert die Benutzeridentität, den Dateipfad und Zeitstempel. Das Speichern von this.log in einer Datenbank oder einer Logdatei, die nur angehängt werden kann, macht dies zu einem dauerhaften Prüfprotokoll. Für Dokumente, die persönlich identifizierbare Informationen enthalten, sollten Sie die PDF-Verschlüsselungsfunktionen von IronPDF verwenden, um Dateien im Ruhezustand zu schützen, bevor sie die Druckwarteschlange erreichen.

Für Serveranwendungen, die Druckanforderungen über HTTP akzeptieren, validieren Sie den Dateityp und die Größe vor dem Drucken - lehnen Sie jeden Upload ab, der kein gültiges PDF-Binärformat ist. Übergeben Sie vom Benutzer bereitgestellte Dateipfade niemals ohne Bereinigung direkt an printer.print().

Was sind die nächsten Schritte for Node.js PDF-Druck?

Dieser Leitfaden behandelte das Drucken bestehender PDF-Dateien auf lokalen und Netzwerkdruckern unter Verwendung von pdf-to-printer, vom einfachen Drucken einzelner Dateien bis hin zu Stapelwarteschlangen, benutzerdefinierten Druckeroptionen, plattformspezifischen Überlegungen und Audit-Protokollierung für regulierte Umgebungen.

Um diesen Workflow mit PDF-Generierung zu erweitern, starten Sie eine kostenlose Testversion von IronPDF for Node.js und folgen Sie dem HTML-zu-PDF-Tutorial, um eine End-to-End-Dokumenten-Pipeline zu erstellen. Für Lizenzierungsoptionen und Volumenpreise, siehe die IronPDF-Lizenzseite.

Bereit, weiterzugehen? Entdecken Sie die vollständige IronPDF for Node.js How-to-Sammlung, um zu lernen, wie man PDF-Dateien zusammenfügt, PDF-Dateien komprimiert und PDFs in Bilder umwandelt.