Jak kompresować pliki PDF za pomocą Node.js

Jakiego ustawienia jakości użyć?

Odpowiednia wartość jakości zależy od tego, w jaki sposób PDF będzie używany po kompresji:

• 90-100: Blisko bezstratna. Używaj, gdy dokument będzie drukowany lub oglądany w pełnym przybliżeniu.
• 80-89: Wysoka jakość, zauważalnie mniejszy plik. Domyślny punkt wyjściowy dla większości dokumentów biznesowych.
• 60-79: Średnia jakość. Akceptowalna do wyświetlania na ekranie, dostarczania przez sieć i jako załączniki do e-mail.
• Poniżej 60: Niska jakość. Nadaje się do miniatur podglądu, kopii archiwalnych lub w przypadkach, gdy rozmiar pliku jest krytyczny.

Jak zmierzyć wynik kompresji w Node.js?

Weryfikacja, że kompresja osiągnęła oczekiwaną redukcję, jest prosta z użyciem modułu fs w Node.js. Przeczytaj rozmiar pliku przed i po wywołaniu compressSize, a następnie oblicz stosunek, aby potwierdzić, że wynik spełnia wymagania Twojej aplikacji.

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

[Node.js `fs.statSync` API](https://nodejs.org/api/fs.html#fsstatsynspath-options) zwraca obiekt `Stats`, który zawiera właściwość `size` w bajtach. Dla procesów produkcyjnych loguj tę proporcję dla każdego dokumentu, aby móc zidentyfikować wyjątki, gdzie kompresja nie zmniejszyła rozmiaru zgodnie z oczekiwaniami – typowo dokumenty zeskanowane już skompresowane przy źródle.

WażneUstaw zmienną środowiskową `IRONPDF_ENGINE_PATH` lub skonfiguruj `IronPdfGlobalConfig` przed przetwarzaniem plików w środowisku serwerowym. Szczegóły konfiguracji silnika znajdziesz w [dokumentacji IronPDF Node.js](https://ironpdf.com/nodejs/docs/).

## Jak skompresować wiele PDF-ów w partii?

Aplikacje produkcyjne rzadko kompresują pojedynczy dokument w izolacji. Poniższy przykład przetwarza tablicę ścieżek plików jednocześnie przy użyciu `Promise.all`, który pozwala pętli zdarzeń Node.js obsługiwać wiele operacji `compressSize` bez blokowania:

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

    zwróć wyniki;
}

// Użycie
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}`));

Każde wywołanie PdfDocument.fromFile i compressSize jest niezależne, co oznacza, że mogą być bezpiecznie równolegle. Dla bardzo dużych partii (setek plików), rozważ podzielenie tablicy, aby unikać przekroczenia limitów pamięci Node.js. Dokumentacja Node.js o pętli zdarzeń wyjaśnia, jak Promise.all harmonogramuje jednoczesne I/O bez blokowania głównego wątku.

Jak połączyć kompresję z innymi operacjami na PDF?

Kompresja naturalnie pasuje do większego łańcucha przetwarzania dokumentów. Częstym schematem jest generowanie PDF z HTML, dodanie znaku wodnego lub podpisu, a następnie kompresja przed dostarczeniem:

```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";

// Renderowanie HTML do PDF const renderer = new ChromePdfRenderer(); const pdf = await renderer.renderHtmlAsPDF("

Kwota do zapłaty: 540,00 $

// Kompresja przed zapisaniem – zmniejsza wagę obrazu w treści renderowanej przez Chrome await pdf.compressSize(85);

// Zapisz ostateczny dokument await pdf.saveAs("invoice-1042.pdf");

Często metoda `ChromePdfRenderer` osadza obrazy tła i zasoby odwołane przez CSS w pełnej rozdzielczości. Wywołanie `compressSize` po renderowaniu konsekwentnie zmniejsza rozmiar pliku dla PDF pochodzących z HTML. Samouczek IronPDF [HTML to PDF](https://ironpdf.com/nodejs/tutorials/html-to-pdf/) szczegółowo opisuje konfigurację renderera.

Dla dokumentów, które również wymagają [podpisów cyfrowych](https://ironpdf.com/nodejs/examples/digitally-sign-a-pdf/), podpisz po kompresji. Podpis blokuje strumień bajtów dokumentu, a dalsza modyfikacja unieważni podpis.

Podczas pracy z dokumentami wielostronicowymi, scalaj je za pomocą [`PdfDocument.merge()`](https://ironpdf.com/nodejs/examples/merge-pdfs/) przed kompresją. Kompresja scalonego wyniku jest bardziej wydajna niż kompresja poszczególnych plików i ponowne scalanie.

PoradyPołącz dokumenty wielostronicowe przed kompresją. Kompresja scalonego wyniku jest bardziej wydajna niż kompresja poszczególnych plików i ponowne scalanie.

## Jakie są kolejne kroki dla kompresji PDF w Node.js?

Metoda `compressSize` obejmuje najczęstszy przypadek użycia kompresji: zmniejszanie wagi osadzonych obrazów. Dla specjalnych scenariuszy przykład [kompresji PDF w IronPDF](https://ironpdf.com/nodejs/examples/pdf-compression/) dostarcza dodatkowych działających przykładów kodu, a [dokumentacja API](https://ironpdf.com/nodejs/object-reference/api/) dokumentuje wszystkie dostępne sygnatury metod.

IronPDF obsługuje również konwersję [obrazów na PDF](https://ironpdf.com/nodejs/examples/image-to-pdf/), [czytanie tekstu PDF](https://ironpdf.com/nodejs/examples/reading-pdf-text/) oraz [usuwanie stron z PDF](https://ironpdf.com/nodejs/examples/remove-page-from-pdf/) - wszystkie operacje wykorzystują to samo API `PdfDocument`. Dla pełnego przeglądu możliwości PDF w Node.js, zobacz [dokumentację IronPDF for Node.js](https://ironpdf.com/nodejs/docs/).

Gotowy, aby przetestować kompresję w swoim projekcie? [Rozpocznij darmowy okres próbny](#trial-license), aby uruchomić powyższe przykłady bez znaku wodnego, lub [zobacz opcje licencyjne](#licensing) dla wdrożeń produkcyjnych.

`PdfDocument`