Printer-pdf-electron-node NPM

printer-pdf-electron-node

Uma biblioteca Node.js para impressão de arquivos PDF com suporte avançado a configurações de impressão. Funciona com Node.js e Electron.

Características

🖨️ Impressão direta de PDFs para qualquer impressora do sistema
📏 Suporte a diferentes tamanhos de papel (A4, Letter, Legal, A3, Custom)
📑 Impressão de páginas específicas ou intervalos
🔄 Ajuste automático do conteúdo à página
📐 Configuração precisa de margens
🎯 Controle de DPI para qualidade de impressão
📚 Impressão de múltiplas cópias
💪 Suporte completo a TypeScript

Requisitos

Node.js >= 18.20.6
Electron >= 20.0.0
Windows ou Linux
Para Windows: Visual Studio Build Tools
Para Linux: CUPS development headers (sudo apt-get install libcups2-dev)

Instalação

npm install printer-pdf-electron-node

Para desenvolvimento:

git clone https://github.com/Alexssmusica/printer-pdf-electron-node.git
cd printer-pdf-electron-node
npm install
npm run rebuild

Uso

JavaScript

const { printPDF } = require('printer-pdf-electron-node');

// Exemplo básico
async function imprimirDocumento() {
    try {
        await printPDF({
            filePath: 'caminho/do/documento.pdf',
            printerName: 'Nome da Impressora'
        });
        console.log('Documento enviado para impressão');
    } catch (error) {
        console.error('Erro ao imprimir:', error);
    }
}

// Exemplo com todas as opções
async function imprimirDocumentoAvancado() {
    try {
        await printPDF({
            // Parâmetros obrigatórios
            filePath: 'caminho/do/documento.pdf',
            printerName: 'Nome da Impressora',
            
            // Parâmetros opcionais
            pageList: [[1, 3], [5, 7]], // Imprime páginas 1-3 e 5-7
            paperSize: 'A4',            // 'A4' | 'LETTER' | 'LEGAL' | 'A3' | 'CUSTOM'
            margins: {
                top: 0.5,    // margens em polegadas
                right: 0.5,
                bottom: 0.5,
                left: 0.5
            },
            fitToPage: true,  // ajusta o conteúdo à página
            width: 0,         // largura personalizada (usado apenas com paperSize: 'CUSTOM')
            height: 0,        // altura personalizada (usado apenas com paperSize: 'CUSTOM')
            dpi: 300,        // resolução de impressão
            copies: 1        // número de cópias
        });
        console.log('Documento enviado para impressão');
    } catch (error) {
        console.error('Erro ao imprimir:', error);
    }
}

TypeScript

import { printPDF, PrintPDFOptions, PaperSize, Margins } from 'printer-pdf-electron-node';

// Definindo as margens
const margins: Margins = {
    top: 0.5,
    right: 0.5,
    bottom: 0.5,
    left: 0.5
};

// Configurando todas as opções
const options: PrintPDFOptions = {
    filePath: 'caminho/do/documento.pdf',
    printerName: 'Nome da Impressora',
    pageList: [[1, 3], [5, 7]],
    paperSize: 'A4',
    margins,
    fitToPage: true,
    dpi: 300,
    copies: 1
};

async function imprimirDocumento() {
    try {
        const resultado = await printPDF(options);
        console.log(resultado); // 'Print job created successfully'
    } catch (error) {
        console.error('Erro ao imprimir:', error);
    }
}

API

`printPDF(options: PrintPDFOptions): Promise<string>`

Opções

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
filePath	string	Sim	-	Caminho do arquivo PDF
printerName	string	Sim	-	Nome da impressora
pageList	Array<number, number>	Não	[]	Lista de intervalos de páginas para imprimir
paperSize	PaperSize	Não	'A4'	Tamanho do papel
margins	Margins	Não	{0,0,0,0}	Margens em polegadas
fitToPage	boolean	Não	true	Ajustar conteúdo à página
width	number	Não	0	Largura personalizada (em pontos)
height	number	Não	0	Altura personalizada (em pontos)
dpi	number	Não	300	Resolução de impressão
copies	number	Não	1	Número de cópias

Tipos

type PaperSize = 'A4' | 'LETTER' | 'LEGAL' | 'A3' | 'CUSTOM';

interface Margins {
    top?: number;    // em polegadas
    right?: number;  // em polegadas
    bottom?: number; // em polegadas
    left?: number;   // em polegadas
}

Notas

As margens são especificadas em polegadas (1 polegada = 25.4mm)
Para tamanhos de papel personalizados (paperSize: 'CUSTOM'), width e height são especificados em pontos (1 ponto = 1/72 polegada)
O DPI padrão é 300, que oferece um bom equilíbrio entre qualidade e performance
A opção fitToPage garante que o conteúdo se ajuste à área imprimível da página