Como compactar arquivos PDF usando Node.js

Qual Configuração de Qualidade Devo Usar?

O valor de qualidade adequado depende de como o PDF será usado após a compressão:

• 90-100: Quase sem perda. Use quando o documento for ser impresso ou visualizado com zoom total.
• 80-89: Alta qualidade, arquivo visivelmente menor. O ponto de partida padrão para a maioria dos documentos empresariais.
• 60-79: Qualidade média. Aceitável para exibição na tela, entrega pela web e anexos de e-mail.
• Abaixo de 60: Baixa qualidade. Adequado para miniaturas de preview, cópias de arquivo ou casos onde o tamanho do arquivo é crítico.

Como Eu Meço o Resultado da Compressão no Node.js?

Verificar se a compressão alcançou a redução esperada é simples utilizando o módulo fs do Node.js. Leia o tamanho do arquivo antes e depois de chamar compressSize, depois calcule a proporção para confirmar que o resultado atende aos requisitos de sua aplicação.

```javascript {.line-numbers} //:path=/static-assets/pdf/content-code-examples/how-to/nodejs-compress-pdf/measure-compression.js import { PdfDocument } from "@ironsoftware/IronPDF"; import { statSync } from "fs";

const inputPath = "annual-report.pdf"; const outputPath = "annual-report-compressed.pdf";

const beforeBytes = statSync(inputPath).size;

const pdf = await PdfDocument.fromFile(inputPath); aguarde pdf.compressSize(75); await pdf.saveAs(outputPath);

const afterBytes = statSync(outputPath).size; const reduction = (((beforeBytes - afterBytes) / beforeBytes) * 100).toFixed(1);

console.log(Before: ${(beforeBytes / 1024).toFixed(1)} KB); console.log(After: ${(afterBytes / 1024).toFixed(1)} KB); console.log(Reduced by ${reduction}%);

A [API `fs.statSync` do Node.js](https://nodejs.org/api/fs.html#fsstatsynspath-options) retorna um objeto `Stats` que inclui a propriedade `size` em bytes. Para pipelines de produção, registre esta proporção por documento para identificar outliers onde a compressão não reduziu o tamanho como esperado -- tipicamente documentos escaneados já comprimidos na fonte.

ImportanteDefina a variável de ambiente `IRONPDF_ENGINE_PATH` ou configure `IronPdfGlobalConfig` antes de processar arquivos em um ambiente de servidor. Veja a [documentação IronPDF Node.js](https://ironpdf.com/nodejs/docs/) para detalhes de configuração do motor.

## Como Eu Comprimir Múltiplos PDFs em Lote?

Aplicações de produção raramente comprimem um único documento isoladamente. O exemplo abaixo processa uma matriz de caminhos de arquivos simultaneamente usando `Promise.all`, que permite ao loop de eventos do Node.js lidar com várias operações `compressSize` sem bloquear:

 ```javascript {.line-numbers}
//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-compress-pdf/batch-compress.js
import { PdfDocument } from "@ironsoftware/IronPDF";
importar caminho de "caminho";

função assíncrona compressPdfFiles(inputPaths, qualidade = 80) {
    const results = await Promise.all(
        inputPaths.map(async (inputPath) => {
            const pdf = await PdfDocument.fromFile(inputPath);
            aguarde pdf.compressSize(qualidade);

            const outputPath = inputPath.replace(".pdf", "-compressed.pdf");
            aguarde pdf.saveAs(outputPath);

            retornar { entrada: inputPath, saída: outputPath };
)}
);

    retornar resultados;
}

// Uso
const files = ["report-q1.pdf", "report-q2.pdf", "report-q3.pdf"];
const compressed = await compressPdfFiles(files, 75);
compressed.forEach(r => console.log(`Saved: ${r.output}`));

Cada chamada para PdfDocument.fromFile e compressSize é independente, tornando-as seguras para paralelização. Para lotes muito grandes (centenas de arquivos), considere dividir a matriz para evitar exceder os limites de memória do Node.js. A documentação do Node.js sobre o loop de eventos explica como Promise.all agenda I/O concorrente sem bloquear o thread principal.

Como Eu Combino Compressão com Outras Operações de PDF?

A compressão se encaixa naturalmente em uma cadeia maior de processamento de documentos. Um padrão comum é gerar um PDF a partir de HTML, adicionar uma marca d'água ou assinatura, depois comprimir antes da entrega:

```javascript {.line-numbers} //:path=/static-assets/pdf/content-code-examples/how-to/nodejs-compress-pdf/compress-after-render.js import { PdfDocument, ChromePdfRenderer } from "@ironsoftware/IronPDF";

// Renderizar HTML para PDF const renderizador = novo ChromePdfRenderer(); const pdf = await renderer.renderHtmlAsPdf("

Montante devido: $540,00

// Comprimir antes de salvar -- reduz o peso da imagem do conteúdo renderizado pelo Chrome aguarde pdf.compressSize(85);

// Salvar o documento final aguarde pdf.saveAs("invoice-1042.pdf");

O `ChromePdfRenderer` frequentemente incorpora imagens de fundo e ativos referenciados pelo CSS em resolução total. Chamar `compressSize` após a renderização reduz consistentemente o tamanho do arquivo para PDFs de origem HTML. O [tutorial de HTML para PDF IronPDF](https://ironpdf.com/nodejs/tutorials/html-to-pdf/) cobre a configuração do renderer em detalhes.

Para documentos que também precisam de [assinaturas digitais](https://ironpdf.com/nodejs/examples/digitally-sign-a-pdf/), aplique a assinatura após a compressão. Assinatura bloqueia o fluxo de bytes do documento, e uma modificação posterior invalidaria a assinatura.

Ao trabalhar com documentos de várias páginas, junte-os com [`PdfDocument.merge()`](https://ironpdf.com/nodejs/examples/merge-pdfs/) antes de comprimir. Comprimir o resultado mesclado é mais eficiente do que comprimir arquivos individuais e mesclar novamente.

PontasMesclar documentos de múltiplas páginas antes de comprimir. Comprimir o resultado mesclado é mais eficiente do que comprimir arquivos individuais e mesclar novamente.

## Quais São os Próximos Passos para Compressão de PDF no Node.js?

O método `compressSize` cobre o caso de uso de compressão mais comum: reduzir o peso das imagens incorporadas. Para cenários especializados, o [exemplo de compressão de PDF IronPDF](https://ironpdf.com/nodejs/examples/pdf-compression/) oferece amostras de código funcional adicionais, e a [referência de API](https://ironpdf.com/nodejs/object-reference/api/) documenta todas as assinaturas de métodos disponíveis.

IronPDF também suporta a conversão de [imagens para PDF](https://ironpdf.com/nodejs/examples/image-to-pdf/), [leitura de texto de PDF](https://ironpdf.com/nodejs/examples/reading-pdf-text/), e [remoção de páginas de um PDF](https://ironpdf.com/nodejs/examples/remove-page-from-pdf/) — todas operações que se integram com a mesma API `PdfDocument`. Para uma visão completa das capacidades de PDF no Node.js, veja os [documentos IronPDF Node.js](https://ironpdf.com/nodejs/docs/).

Pronto para testar a compressão em seu projeto? [Comece seu teste gratuito](#trial-license) para executar os exemplos acima sem marca d'água, ou [veja as opções de licenciamento](#licensing) para implantação de produção.

`PdfDocument`