Como imprimir arquivos PDF usando Node.js

Quais são os pré-requisitos para imprimir PDFs em Node.js?

Node.js 14.x ou posterior e npm são necessários antes de usar pdf-to-printer. O pacote depende de comandos de impressão nativos do SO em vez de um mecanismo de impressão embutido, portanto, os drivers de impressora já devem estar configurados na máquina de destino.

No Windows, o pacote chama SumatraPDF via PowerShell. Certifique-se de que a execução de scripts do PowerShell não esteja bloqueada pela política do seu sistema. No macOS e Linux, o pacote delega ao comando lp, que faz parte do sistema de impressão CUPS. Confirme se o CUPS está instalado e se pelo menos uma impressora está registrada com lpstat -p.

Como configuro um projeto Node.js para impressão de PDF?

Inicialize um novo projeto, instale o pacote e crie uma estrutura de diretório mínima antes de escrever qualquer lógica de impressão.

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

Após a instalação, crie um arquivo index.js para sua lógica de impressão e uma pasta pdfs/ para armazenar os documentos que você deseja imprimir. Um config.js separado para configurações de impressora mantém os nomes das impressoras fora da sua lógica central -- um padrão útil para implantações em vários ambientes onde a impressora de destino difere entre desenvolvimento e produção.

O módulo usa bindings nativos que são resolvidos em tempo de execução, portanto, nenhum passo de compilação é necessário. O diretório node_modules/pdf-to-printer/dist/ conterá binários pré-compilados para a plataforma detectada.

Como imprimo um arquivo PDF com uso básico?

Passe o caminho do arquivo absoluto ou relativo para printer.print(). O método coloca o documento em fila com a impressora padrão do sistema e resolve a Promessa assim que o trabalho é aceito pelo spooler — não quando a impressão física é concluída.

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

Verificar a existência do arquivo antes de chamar printer.print() previne falhas silenciosas quando um caminho está errado ou um arquivo foi movido. A chamada fs.access() lança ENOENT se o caminho não for resolvido, dando-lhe um erro descritivo em vez de uma rejeição genérica do spooler. As causas comuns de erros incluem caminhos relativos incorretos, drivers de impressora ausentes e status offline da impressora.

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

Como faço para especificar opções de impressora personalizadas?

Passe um objeto printerOptions como o segundo argumento para printer.print() para direcionar uma impressora específica, definir a quantidade de cópias, selecionar intervalos de páginas ou controlar a escala da página. O nome da impressora deve corresponder exatamente ao valor retornado por 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);

Chamar getPrinters() antes de print() serve a dois propósitos: ele confirma que a impressora está online e acessível, e fornece a string de nome autoritativa que o sistema operacional usa para rotear trabalhos de impressão. Os nomes das impressoras geralmente incluem números de versão ou sufixos de rede que diferem dos nomes de exibição mostrados nas configurações do sistema.

Quais opções de impressora podem ser configuradas?

O objeto printerOptions suporta os seguintes campos:

pdf-to-printer option properties

Opção	Tipo	Descrição	Exemplo de valor
printer	string	Nome exato da impressora como retornado por getPrinters()	'HP LaserJet Pro'
copies	number	Número de cópias a imprimir	2
pages	string	Cadeia de caracteres de intervalo de páginas	'1-3,5'
scale	string	Modo de escalonamento de página	'fit' , 'noscale' , 'shrink'
orientation	string	Substituição da orientação da página	'portrait' , 'landscape'

Para documentos que precisam de tamanhos de papel personalizados ou de uma orientação de página específica aplicada durante a geração de PDF em vez de no momento da impressão, configure essas opções na etapa de renderização do IronPDF antes de salvar o arquivo.

Minha biblioteca favorita desse tipo é o IronPDF. Ele permite a manipulação rápida e eficiente de arquivos PDF. Além disso, possui muitos recursos valiosos, como a exportação para o formato PDF/A e a assinatura digital de documentos PDF.

Milan Jovanovic

Microsoft MVP

Veja o estudo de caso

Com o IronOCR, podemos economizar US$ 40.000 por ano em processamento manual, ao mesmo tempo que aumentamos a produtividade e liberamos recursos para tarefas de alto impacto. Eu o recomendo fortemente.

Brent Matzelle

Diretor de Tecnologia, OPYN

Veja o estudo de caso

O IronSuite desempenha um papel crucial nas nossas operações. Estas são ferramentas que aumentam a eficiência no negócio, incluindo a criação de plantas baixas e melhoria na gestão de inventário.

David Jones

Engenheiro(a) de Software Líder, Agorus Build

Veja o estudo de caso

Como posso implementar impressão em lote em Node.js?

Processar uma pasta de arquivos PDF ou uma lista gerada dinamicamente por meio de iteração de um array e chamar printer.print() para cada arquivo. Usar for...of com await mantém os trabalhos sequenciais, o que impede que o spooler de impressão fique sobrecarregado com solicitações simultâneas.

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

A classe BatchPrinter separa a validação da execução. Arquivos que não existem são ignorados durante addFiles() para que um único arquivo ausente não aborte todo o lote. O método printAll() registra erros por arquivo e retorna um resumo que pode ser registrado ou encaminhado para um serviço de monitoramento.

Para relatórios gerados dinamicamente, combine este padrão com a conversão de string HTML para PDF do IronPDF para gerar e imprimir em um único pipeline. O exemplo de compressão de PDF vale a pena aplicar antes de lotes de impressão grandes para reduzir o tempo de transferência do spooler em impressoras de rede.

Quais são as considerações específicas de plataforma para impressão de PDF em Node.js?

O pacote pdf-to-printer usa comandos de sistema diferentes em cada sistema operacional. Compreender o mecanismo subjacente ajuda a diagnosticar falhas específicas da plataforma.

Como lido com segurança e permissões ao imprimir PDFs?

Sistemas de impressão de produção que processam documentos confidenciais — contratos, registros financeiros, formulários médicos — precisam de controles de acesso e trilhas de auditoria. Rastrear quem imprimiu o quê e quando é uma exigência de conformidade em muitas indústrias reguladas.

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

A classe AuditedPrinter atribui um ID de trabalho único a cada solicitação de impressão e registra a identidade do usuário, caminho do arquivo e carimbos de data e hora. Persistir this.log em um banco de dados ou arquivo de log de acréscimo único transforma isso em um registro de auditoria durável. Para documentos que contêm informações de identificação pessoal, considere usar os recursos de criptografia de PDF do IronPDF para proteger arquivos em repouso antes de chegarem à fila de impressora.

Para aplicativos de servidor que aceitam solicitações de impressão via HTTP, valide o tipo e tamanho do arquivo antes de imprimir — rejeite qualquer upload que não seja um binário PDF válido. Nunca passe caminhos de arquivo fornecidos pelo usuário diretamente para printer.print() sem saneamento.

Quais são os próximos passos para impressão de PDF em Node.js?

Este guia cobriu a impressão de arquivos PDF existentes para impressoras locais e de rede usando pdf-to-printer, desde a impressão básica de arquivo único até filas em lote, opções de impressora personalizada, considerações de plataforma e registro de auditoria para ambientes regulamentados.

Para estender este fluxo de trabalho com geração de PDF, inicie um teste gratuito do IronPDF for Node.js e siga o tutorial de HTML para PDF para construir um pipeline de documentos de ponta a ponta. Para opções de licenciamento e preços por volume, veja a página de licenciamento do IronPDF.

Pronto para ir mais longe? Explore a coleção completa de tutoriais de IronPDF for Node.js para aprender como mesclar arquivos PDF, comprimir arquivos PDF e converter PDFs em imagens.