Node.js를 사용하여 PDF 파일을 인쇄하는 방법

Node.js에서 PDF를 인쇄하기 위한 사전 요구 사항은 무엇인가요?

Node.js 14.x 이상 버전과 npm이 pdf-to-printer 사용 전에 필요합니다. 패키지는 번들 인쇄 엔진 대신 Native OS 인쇄 명령에 의존하므로, 타겟 머신에 프린터 드라이버가 이미 구성되어 있어야 합니다.

Windows에서는 이 패키지가 PowerShell을 통해 SumatraPDF를 호출합니다. 시스템 정책에 의해 PowerShell 스크립트 실행이 차단되지 않았는지 확인하십시오. macOS 및 Linux에서는 이 패키지가 CUPS 인쇄 시스템의 일부분인 lp 명령어를 위임합니다. 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()와 함께 절대 또는 상대 파일 경로를 전달하십시오. 이 메서드는 시스템 기본 프린터로 문서를 큐에 놓고 작업이 스풀러에 수락되면 약속을 해결합니다 — 물리적 인쇄가 완료될 때가 아닙니다.

//: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() 호출 전에 파일 존재 여부를 확인하면 경로가 잘못됐거나 파일이 이동된 경우 묵시적인 실패를 방지할 수 있습니다. 경로가 해결되지 않으면 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.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 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);

getPrinters()을 호출하여 print() 전에 프린터가 온라인 상태이고 접근 가능한지 확인하는 동시에 OS에서 인쇄 작업을 라우팅하는 데 사용하는 권위있는 이름 문자열을 제공합니다. 프린터 이름은 종종 시스템 설정에 표시되는 표시 이름과 다른 버전 번호나 네트워크 접미사를 포함할 수 있습니다.

어떤 프린터 옵션을 구성할 수 있나요?

printer옵션s 객체는 다음 필드를 지원합니다:

pdf-to-printer option properties

옵션	유형	설명	예시 값
프린터	string	getPrinters()에 의해 반환된 정확한 프린터 이름	'HP LaserJet Pro'
사본	number	인쇄할 복사본 수	2
페이지	string	페이지 범위 문자열	'1-3,5'
scale	string	페이지 축척 모드	'fit', 'noscale', 'shrink'
방향	string	페이지 방향 재정의	'세로 방향', '가로 방향'

PDF 생성 중에가 아닌 인쇄 시 사용자 정의 용지 크기나 특정 페이지 방향이 필요하다면, 파일을 저장하기 전에 IronPDF 렌더링 단계에서 옵션을 구성하십시오.

이 종류의 라이브러리 중 가장 좋아하는 것은 IronPDF입니다. PDF 파일을 빠르고 효율적으로 조작할 수 있습니다. 또한 PDF/A 형식으로 내보내기 및 PDF 문서의 디지털 서명과 같은 많은 유용한 기능을 가지고 있습니다.

Milan Jovanovic

마이크로소프트 MVP

사례 연구 보기

IronOCR 덕분에 연간 $40,000를 수동 프로세싱에서 절약하고 생산성을 높이며 고부가가치 작업에 자원을 활용할 수 있습니다. 강력히 추천합니다.

브렌트 마첼

최고 기술 책임자, OPYN

사례 연구 보기

IronSuite는 우리의 운영에서 중요한 역할을 합니다. 이것들은 사업 전반에 걸쳐 효율성을 높이는 도구로, 평면도 생성 및 재고 관리 개선을 포함합니다.

데이비드 존스

리드 소프트웨어 엔지니어, Agorus Build

사례 연구 보기

Node.js에서 배치 인쇄를 구현하려면 어떻게 해야 하나요?

PDF 파일 폴더나 동적으로 생성된 목록을 배열을 반복하여 각 파일에 대해 printer.print()을 호출하여 처리하십시오. 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 패키지는 각 OS마다 다른 시스템 명령어를 사용합니다. 기저 메커니즘을 이해하면 플랫폼별 실패를 진단하는 데 도움이 됩니다.

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 클래스는 모든 인쇄 요청에 고유한 작업 ID를 할당하고 사용자 ID, 파일 경로 및 타임스탬프를 기록합니다. 이를 데이터베이스나 추가 전용 로그 파일에 지속하면 이를 내구성 있는 감사 기록으로 변환합니다. 개인 식별 정보를 포함하는 문서의 경우, 프린터 대기열에 도착하기 전에 파일을 보호하기 위해 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를 이미지로 변환 방법을 배워보세요.