Node.js Kullanarak PDF Dosyalarını Nasıl Yazdırırım

Node.js'de PDF Yazdırmanın Önkoşulları Nelerdir?

pdf-to-printer'yi kullanmadan önce Node.js 14.x veya üstü sürümü ve npm gereklidir. Paket, birleştirilmiş yazıcı motoru yerine yerel OS yazdırma komutlarına bağlıdır, bu nedenle yazıcı sürücüleri zaten hedef makinede yapılandırılmış olmalıdır.

Windows'ta, paket PowerShell üzerinden SumatraPDF'yi çağırır. PowerShell komut dosyası çalıştırılmasının sistem politikanız tarafından engellenmediğinden emin olun. macOS ve Linux'ta, paket CUPS yazdırma sisteminin bir parçası olan lp komutuna devredilir. CUPS'un kurulu olduğunu ve en az bir yazıcının lpstat -p ile kayıtlı olduğunu doğrulayın.

Node.js Projesi PDF Yazdırmak İçin Nasıl Kurulur?

Yeni bir proje başlatın, paketi yükleyin ve herhangi bir yazdırma mantığı yazmadan önce minimal bir dizin yapısı oluşturun.

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

Kurulumdan sonra, yazdırma mantığınız için bir index.js dosyası ve yazdırmak istediğiniz belgeleri barındıracak bir pdfs/ klasörü oluşturun. Yazıcı ayarları için ayrı bir config.js kullanılması, yazıcı adlarının temel mantığınızdan uzak tutulmasını sağlar. Bu, geliştirme ve üretim ortamlarında hedef yazıcının farklı olduğu çoklu ortam dağıtımları için yararlı bir modeldir.

Modül, çalışma zamanında çözülen yerel bağlamaları kullanır, bu yüzden bir derleme adımı gerekmez. node_modules/pdf-to-printer/dist/ dizini, algılanan platform için önceden derlenmiş ikili dosyaları içerecektir.

Temel Kullanım için PDF Dosyası Nasıl Yazdırılır?

Mutlak veya göreceli dosya yolunu printer.print()'ye aktarın. Yöntem, belgeyi sistem varsayılan yazıcısı ile sıraya koyar ve iş kuyruğu tarafından kabul edildiğinde Promise'i çözer — baskı fiziksel olarak tamamlandığında değil.

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

printer.print() çağrısı yapılmadan önce dosyanın varlığı kontrol edilirse, yol yanlış olduğunda veya dosya taşındığında sessiz hatalar önlenir. fs.access() çağrısı, yol çözümlenmezse ENOENT hatasını verir ve genel bir spooler reddi yerine açıklayıcı bir hata mesajı sunar. Yaygın hata nedenleri arasında yanlış göreceli yollar, eksik yazıcı sürücüleri ve yazıcının çevrimdışı durumu bulunur.

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

Özel Yazıcı Seçenekleri Nasıl Belirtilir?

Belirli bir yazıcıyı hedeflemek, kopya sayısını ayarlamak, sayfa aralıklarını seçmek veya sayfa ölçeklendirmesini kontrol etmek için printerSeçeneks nesnesini printer.print()'nin ikinci argümanı olarak geçirin. Yazıcı adı, printer.getPrinters() tarafından döndürülen değerle tam olarak eşleşmelidir.

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

async function printWithSeçeneks(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}"`);
}

printWithSeçeneks('./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 printWithSeçeneks(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}"`);
}

printWithSeçeneks('./pdfs/shipping-label.pdf').catch(console.error);

getPrinters()'yi print()'dan önce çağırmanın iki amacı vardır: yazıcının çevrimiçi ve erişilebilir olduğunu doğrular ve işletim sisteminin yazdırma işlerini yönlendirmek için kullandığı yetkili ad dizesini verir. Yazıcı adları genellikle sistem ayarlarında gösterilen görüntü adlarından farklı olarak sürüm numaralarını veya ağ eklerini içerir.

Node.js'de Toplu Yazdırmayı Nasıl Uygularım?

Bir dizi üzerinde yineleme yaparak ve her dosya için printer.print() işlevini çağırarak bir PDF dosyaları klasörünü veya dinamik olarak oluşturulan bir listeyi işleyin. for...of ile await işlevini birlikte kullanmak, işlerin sırayla yürütülmesini sağlar ve bu da yazdırma kuyruğunun eşzamanlı isteklerle aşırı yüklenmesini önler.

//: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 printSeçeneks = {
          ...options,
          ...(this.printerName && { printer: this.printerName }),
        };
        await printer.print(filePath, printSeçeneks);
        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 printSeçeneks = {
          ...options,
          ...(this.printerName && { printer: this.printerName }),
        };
        await printer.print(filePath, printSeçeneks);
        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 sınıfı, doğrulamayı yürütmeden ayırır. addFiles() sırasında mevcut olmayan dosyalar atlanır, böylece tek bir eksik dosya tüm işlemeyi durdurmaz. printAll() yöntemi, dosya başına hataları kaydeder ve günlüğe kaydedilebilen veya bir izleme hizmetine iletilebilen bir özet döndürür.

Dinamik olarak üretilmiş raporlar için, bu örüntüyü IronPDF'nin HTML string to PDF dönüştürme yöntemiyle birleştirin ve tek bir iş akışında oluşturup yazdırın. PDF sıkıştırma örneği, büyük yazdırma işlerinden önce ağ yazıcılarında transfer süresini azaltmak için uygulanmaya değer.

Node.js PDF Yazdırma İçin Platforma Özel Hususlar Nelerdir?

pdf-to-printer paketi, her işletim sisteminde farklı sistem komutları kullanır. Altta yatan mekanizmayı anlamak, platforma özel hataların teşhis edilmesine yardımcı olur.

PDF'leri Yazdırırken Güvenlik ve İzinleri Nasıl İdare Ederim?

Sözleşmeler, finansal kayıtlar, tıbbi formlar gibi hassas belgeleri işleyen üretim yazdırma sistemleri erişim kontrolleri ve denetim izleri gerektirir. Ne ve ne zaman kimin yazdırdığını takip etmek, birçok düzenlenmiş sektörde uyum şartıdır.

//: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 sınıfı, her PRINT isteğine benzersiz bir iş kimliği atar ve kullanıcı kimliğini, dosya yolunu ve zaman damgalarını kaydeder. this.log'yi bir veritabanına veya yalnızca ekleme yapılabilen bir günlük dosyasına kaydetmek, bunu kalıcı bir denetim kaydı haline getirir. Kişisel olarak tanımlanabilir bilgiler içeren belgeler için, dosyaları yazıcı kuyruğuna ulaşmadan önce korumak için IronPDF'nin PDF şifreleme özelliklerini kullanmayı düşünün.

HTTP üzerinden yazdırma isteklerini kabul eden sunucu uygulamaları için, yazdırmadan önce dosya türünü ve boyutunu doğrulayın -- geçerli PDF ikilisi olmayan herhangi bir yüklemeyi reddedin. Kullanıcı tarafından sağlanan dosya yollarını, temizleme işlemi yapılmadan asla doğrudan printer.print()'ye aktarmayın.

Denetim günlüklerini uygulamanın yazılabilir dizininin dışında saklayın. Dosya sistemi yazma erişimi olan bir saldırganın yazdırma kayıtlarını değiştirememesi gerekir.

Node.js PDF Yazdırmaya Başlamak için Sonraki Adımlar Nelerdir?

Bu kılavuz, pdf-to-printer kullanılarak mevcut PDF dosyalarının yerel ve ağ yazıcılarına yazdırılmasını, temel tek dosya yazdırmadan toplu iş kuyruklarına, özel yazıcı seçeneklerine, platformla ilgili hususlara ve düzenlemelere tabi ortamlar için denetim günlüğüne kadar ele almıştır.

PDF oluşturma ile iş akışını genişletmek için, Node.js için IronPDF'nin ücretsiz deneme sürümüne başlayın ve HTML'den PDF'ye öğreticini izleyerek baştan sona bir belge hattı oluşturun. Lisanslama seçenekleri ve hacim fiyatları için IronPDF lisanslama sayfasına bakın.

Daha da ileriye gitmeye hazır mısınız? PDF dosyalarını birleştirme, PDF dosyalarını sıkıştırma ve PDF dosyalarını image'lere dönüştürme gibi çeşitli konuları öğrenmek için tüm Node.js için IronPDF nasıl yapılır koleksiyonunu keşfedin.