Cómo comprimir archivos PDF con Node.js

¿Qué Configuración de Calidad Debería Usar?

El valor de calidad correcto depende de cómo se usará el PDF después de la compresión:

• 90-100: Casi sin pérdida. Úselo cuando el documento se imprimirá o se verá a zoom completo.
• 80-89: Alta calidad, archivo perceptiblemente más pequeño. El punto de partida predeterminado para la mayoría de los documentos de negocios.
• 60-79: Calidad media. Aceptable para visualización en pantalla, entrega web y adjuntos de correo electrónico.
• Por debajo de 60: Baja calidad. Adecuado para miniaturas de vista previa, copias de archivo o casos donde el tamaño del archivo es crítico.

¿Cómo Medir el Resultado de la Compresión en Node.js?

Verificar que la compresión logró la reducción esperada es sencillo usando el módulo fs de Node.js. Lee el tamaño del archivo antes y después de llamar a compressSize, luego calcula la relación para confirmar que el resultado cumple con los requisitos de tu aplicación.

```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); await 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}%);

La [API `fs.statSync` de Node.js](https://nodejs.org/api/fs.html#fsstatsynspath-options) devuelve un objeto `Stats` que incluye la propiedad `size` en bytes. Para las tuberías de producción, registre esta proporción por documento para que pueda identificar los casos atípicos donde la compresión no redujo el tamaño como se esperaba, generalmente documentos escaneados ya comprimidos en la fuente.

ImportanteEstablece la variable de entorno `IRONPDF_ENGINE_PATH` o configura `IronPdfGlobalConfig` antes de procesar archivos en un entorno de servidor. Consulte la [documentación de IronPDF for Node.js](https://ironpdf.com/nodejs/docs/) para detalles sobre la configuración del motor.

## ¿Cómo Comprimir Múltiples PDFs en un Lote?

Las aplicaciones de producción rara vez comprimen un solo documento de forma aislada. El ejemplo a continuación procesa un arreglo de rutas de archivos simultáneamente utilizando `Promise.all`, lo que permite al bucle de eventos de Node.js manejar múltiples operaciones `compressSize` sin bloquear:

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

async function compressPdfFiles(inputPaths, quality = 80) {
const results = await Promise.all(
inputPaths.map(async (inputPath) => {
const pdf = await PdfDocument.fromFile(inputPath);
await pdf.compressSize(quality);

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

return { input: inputPath, output: outputPath };
})
);

return results;
}

// 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 llamada a PdfDocument.fromFile y compressSize es independiente, haciéndolas seguras para paralelizar. Para lotes muy grandes (cientos de archivos), considera dividir el arreglo para evitar exceder los límites de memoria de Node.js. La documentación de Node.js sobre el bucle de eventos explica cómo Promise.all programa I/O concurrente sin bloquear el hilo principal.

¿Cómo Combinar la Compresión con Otras Operaciones PDF?

La compresión se integra naturalmente en una cadena de procesamiento de documentos más grande. Un patrón común es generar un PDF a partir de HTML, agregar una marca de agua o firma, y luego comprimir antes de la 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 a PDF const renderer = new ChromePdfRenderer(); const pdf = await renderer.renderHtmlAsPdf("

Cantidad debida: $540.00

// Comprimir antes de guardar: reduce el peso de la imagen del contenido renderizado por Chrome await pdf.compressSize(85);

// Guardar el documento final await pdf.saveAs("invoice-1042.pdf");

El `ChromePdfRenderer` a menudo incrusta imágenes de fondo y recursos referenciados por CSS a resolución completa. Llamar a `compressSize` después de renderizar reduce consistentemente el tamaño del archivo para PDFs originados en HTML. El [tutorial de HTML a PDF de IronPDF](https://ironpdf.com/nodejs/tutorials/html-to-pdf/) cubre en detalle la configuración del renderizador.

Para documentos que también necesitan [firmas digitales](https://ironpdf.com/nodejs/examples/digitally-sign-a-pdf/), aplique la firma después de la compresión. Firmar bloquea la secuencia de bytes del documento y una modificación posterior anularía la firma.

Cuando trabajes con documentos multipágina, fusiónalos con [`PdfDocument.merge()`](https://ironpdf.com/nodejs/examples/merge-pdfs/) antes de comprimir. Comprimir el resultado fusionado es más eficiente que comprimir archivos individuales y volver a fusionar.

ConsejosFusione documentos de varias páginas antes de comprimir. Comprimir el resultado fusionado es más eficiente que comprimir archivos individuales y volver a fusionar.

## ¿Cuáles Son los Siguientes Pasos para la Compresión de PDFs en Node.js?

El método `compressSize` cubre el caso de uso más común de compresión: reducir el peso de la imagen incrustada. Para escenarios especializados, el [ejemplo de compresión de PDF de IronPDF](https://ironpdf.com/nodejs/examples/pdf-compression/) proporciona más muestras de código funcional, y la [referencia de API](https://ironpdf.com/nodejs/object-reference/api/) documenta todas las firmas de método disponibles.

IronPDF también admite convertir [imágenes a PDF](https://ironpdf.com/nodejs/examples/image-to-pdf/), [leer texto de PDF](https://ironpdf.com/nodejs/examples/reading-pdf-text/) y [eliminar páginas de un PDF](https://ironpdf.com/nodejs/examples/remove-page-from-pdf/) -- todas operaciones que se integran con la misma API `PdfDocument`. Para una visión completa de las capacidades de PDF en Node.js, consulte la [documentación de IronPDF for Node.js](https://ironpdf.com/nodejs/docs/).

¿Listo para probar la compresión en su proyecto? [Comience su prueba gratuita](#trial-license) para ejecutar los ejemplos anteriores sin una marca de agua, o [vea las opciones de licenciamiento](#licensing) para despliegue de producción.

`PdfDocument`