如何使用Node.js壓縮PDF文件

我應該使用什麼品質設定？

正確的品質值取決於PDF壓縮後如何使用：

• 90-100：接近無損。 文件將被列印或以全縮放視圖時使用。
• 80-89：高品質，可明顯減少文件大小。大多數商業文件的預設起始點。
• 60-79：中等品質。 可接受於螢幕顯示、網頁傳輸和電子郵件附件。
• 低於60：低品質。 適於預覽縮圖、歸檔副本或文件大小至關重要的情況。

如何在Node.js中測量壓縮結果？

檢驗壓縮是否達到預期的減量是使用Node.js fs 模塊的一個簡單過程。 在調用compressSize之前和之後讀取文件大小，然後計算比率以確認結果符合您應用程式的要求。

```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) 返回一個包含`size` 屬性的`Stats` 物件（以位元為單位）。 對於生產管道，為每個文件記錄該比率，以便識別壓縮未如預期減小大小的異常情況--通常是已經在源頭進行壓縮的掃描文件。

重要在伺服器環境中處理文件前，設置`IRONPDF_ENGINE_PATH` 環境變數或配置`IronPdfGlobalConfig`。 詳情請參閱 [IronPDF Node.js文件](https://ironpdf.com/nodejs/docs/)的引擎設置詳情。

## 如何批量壓縮多個PDF？

生產應用程式不太可能單獨壓縮一個文件。 以下範例使用`Promise.all` 同時處理一個文件路徑陣列，這樣Node.js事件迴圈可以處理多個`compressSize` 操作而不阻塞：

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

// 使用範例
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}`));

每次調用PdfDocument.fromFile 和compressSize都是獨立的，使它們能安全地進行並行化。對於非常大的批次（數百個文件），考慮將陣列分塊以避免超過Node.js記憶體限制。 Node.js文件中關於事件迴圈 的說明解釋了Promise.all如何計劃並行I/O，而不阻塞主執行緒。

如何將壓縮與其他PDF操作結合使用？

壓縮自然適合整個文件處理鏈。 一個常見模式是從HTML生成PDF，新增水印或簽名，然後壓縮再傳送：

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

// 將HTML渲染成PDF const renderer = new ChromePdfRenderer(); const pdf = await renderer.renderHtmlAsPdf("

Amount due: $540.00

// 保存前先壓縮 -- 減少從Chrome渲染內容中的圖像重量 await pdf.compressSize(85);

// 保存最終文件 await pdf.saveAs("invoice-1042.pdf");

`ChromePdfRenderer`通常將背景圖像和CSS引用的資產以完整解析度嵌入。 在渲染之後調用`compressSize`可以不變地減小HTML來源的PDF文件大小。 IronPDF [HTML到PDF的教程](https://ironpdf.com/nodejs/tutorials/html-to-pdf/)詳細介紹了渲染器配置。

對於也需要[數位簽名](https://ironpdf.com/nodejs/examples/digitally-sign-a-pdf/)的文件，請在壓縮後應用簽名。 簽名會鎖定文件的位元流，進一步的修改會使簽名失效。

在處理多頁文件時，[使用`PdfDocument.merge()`合併它們](https://ironpdf.com/nodejs/examples/merge-pdfs/)再進行壓縮。 壓縮合併後的結果比壓縮單個文件並重新合併更為高效。

提示合併多頁文件後再壓縮。 壓縮合併後的結果比壓縮單個文件並重新合併更為高效。

## Node.js中PDF壓縮的下一步是什麼？

`compressSize` 方法涵蓋了最常見的壓縮用例：減少嵌入圖像重量。 對於專業場景，IronPDF [PDF壓縮範例](https://ironpdf.com/nodejs/examples/pdf-compression/)提供了額外的工作程式碼範例，以及[API參考](https://ironpdf.com/nodejs/object-reference/api/)記錄了所有可用的方法簽名。

IronPDF還支持將[圖像轉換為PDF](https://ironpdf.com/nodejs/examples/image-to-pdf/)、[讀取PDF文字](https://ironpdf.com/nodejs/examples/reading-pdf-text/)，以及[從PDF中刪除頁面](https://ironpdf.com/nodejs/examples/remove-page-from-pdf/)-- 這些操作均整合於相同的`PdfDocument` API中。 欲全面了解Node.js PDF功能，請參閱[IronPDF Node.js 文件](https://ironpdf.com/nodejs/docs/)。

準備好在您的專案中測試壓縮了嗎？ [開始您的免費試用](#trial-license)以運行上述範例而無水印，或[查看生產部署的授權選項](#licensing)。

`PdfDocument`