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

Passe um objeto printerOpçãos como segundo argumento para printer.print() para direcionar uma impressora específica, definir a contagem de cópias, selecionar intervalos de páginas ou controlar o dimensionamento 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 printWithOpçãos(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}"`);
}

printWithOpçãos('./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 printWithOpçãos(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}"`);
}

printWithOpçãos('./pdfs/shipping-label.pdf').catch(console.error);

Chamar getPrinters() antes de print() serve a dois propósitos: confirma que a impressora está online e acessível e fornece a corda de nome autorizada que o sistema operacional usa para encaminhar os 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 printerOpçãos suporta os seguintes campos:

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.

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

Processa uma pasta de arquivos PDF ou uma lista gerada dinamicamente, iterando sobre um array e chamando printer.print() para cada arquivo. O uso de for...of com await mantém os trabalhos sequenciais, o que evita que o spooler de impressão seja 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 printOpçãos = {
          ...options,
          ...(this.printerName && { printer: this.printerName }),
        };
        await printer.print(filePath, printOpçãos);
        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 printOpçãos = {
          ...options,
          ...(this.printerName && { printer: this.printerName }),
        };
        await printer.print(filePath, printOpçãos);
        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. Os arquivos que não existem são ignorados durante addFiles() para que um único arquivo ausente não interrompa todo o lote. O método printAll() registra erros por arquivo e retorna um resumo que pode ser armazenado em log ou encaminhado para um serviço de monitoramento.

Para relatórios gerados dinamicamente, combine este padrão com a conversão de corda 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 utiliza comandos de sistema diferentes em cada sistema operacional. Compreender o mecanismo subjacente ajuda a diagnosticar falhas específicas da plataforma.

Como funciona a impressão de PDF no Windows?

No Windows, pdf-to-printer executa um comando do PowerShell no SumatraPDF. O SumatraPDF é incorporado ao pacote — nenhuma instalação separada é necessária. A execução de scripts do PowerShell deve ser permitida de acordo com a política de execução atual. Execute Get-ExecutionPolicy no PowerShell para verificar; Se o resultado for Restricted, defina-o como RemoteSigned ou Bypass para a sessão.

Os nomes de impressoras no Windows são sensíveis a maiúsculas e minúsculas e devem corresponder exatamente ao valor mostrado em Configurações > Bluetooth & dispositivos > Impressoras e scanners, incluindo qualquer sufixo de rede entre parênteses.

Como funciona a impressão de PDF no macOS e Linux?

No macOS e no Linux, o pacote chama lp (parte do CUPS). Confirme se o CUPS está em execução com lpstat -p -- esta mensagem lista todas as impressoras registradas e seus respectivos status atuais. Se nenhuma impressora aparecer, o serviço CUPS pode não estar iniciado; Use sudo systemctl start cups no Linux ou habilite-o através de Preferências do Sistema > Impressoras no macOS.

O comando lp não suporta todas as mesmas opções que o caminho do SumatraPDF no Windows. As opções scale e orientation podem não ter efeito na impressão baseada em CUPS, dependendo do driver da impressora. Teste no hardware de destino antes de implantar.

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 exclusivo a cada solicitação de impressão e registra a identidade do usuário, o caminho do arquivo e os registros de data e hora. Persistir this.log em um banco de dados ou arquivo de log somente para anexação transforma isso em um registro de auditoria permanente. 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 arquivos fornecidos pelo usuário diretamente para printer.print() sem sanitização.

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

Este guia abordou a impressão de arquivos PDF existentes em impressoras locais e de rede usando pdf-to-printer, desde a impressão básica de arquivo único até filas de lotes, opções de impressora personalizadas, 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.