使用IRONPDF FOR NODE.JS

如何在Node.js中编辑PDF文件

发布 2024年一月27日

简介

PDF 文档已成为数字文档的基本要素，因其可靠性和安全性而备受推崇。它们在各种平台上保持一致的格式，使其成为许多专业应用的首选。然而，修改或更新现有 PDF 文档的必要性在许多专业环境中经常出现，这反映了数字信息管理的动态性质。Node.js 是一种功能强大的 JavaScript 运行时，可以与 IronPDF 库搭配使用，从而高效地编辑和处理 PDF 文档。本教程旨在指导初学者了解在 Node.js 中使用 IronPDF 编辑和创建 PDF 文件的基础知识。

了解 IronPDF

如何在 Node.js 中编辑 PDF 文件：图 1 - IronPDF for Node.js：Node.js PDF 库

IronPDF 是一个与 Node.js 无缝集成的 PDF 库，为 PDF 操作提供了一系列令人惊叹的功能。它能让开发人员创建新的简单 PDF 文档、修改现有 PDF 文档、添加自定义字体，甚至合并多个 PDF 文件。在深入了解技术细节之前，重要的是要掌握 IronPDF 的基本原理以及它在 Node.js 环境中的交互方式。

如何使用 Node.js 库编辑 PDF

1.创建一个新的 Node.js 应用程序。

2.使用 npm 安装编辑 PDF 库。

3.使用 fromFile 方法在应用程序中加载 PDF 文档。

4.添加数字签名、密码和其他所需的修改。

5.使用 SaveAs 方法保存 PDF 文件。

设置你的环境

在开始在 Node.js 应用程序中处理 PDF 之前，您需要设置环境。以下是您需要遵循的步骤：

1.安装 Node.js：访问 Node.js 官方网站 nodejs.org 并为您的操作系统下载和安装最新稳定版本的 Node.js。

2.创建新的项目目录：打开终端或命令提示符，使用以下命令为项目创建一个新目录：

   mkdir pdf-editing-project

导航至项目目录：使用以下命令更改到项目目录：

   cd pdf-editing-project

初始化新的 Node.js 项目：运行以下命令在项目目录中初始化一个新的 Node.js 项目：

   npm init -y

这将创建一个包含默认值的 package.json 文件。

5.安装 PDF 编辑库：使用 npm 安装你选择的 PDF 编辑库。例如，如果要使用 "pdf-lib "库，请运行以下命令：

   npm install pdf-lib

这将安装 "pdf-lib "库，并将其作为依赖项添加到 "package.json "文件中。

6.创建应用程序文件创建新的 JavaScript 文件 (例如，"app.js) 在项目目录中打开，并在您最喜欢的代码编辑器中打开。

7.现在，您就可以开始编码并在 Node.js 应用程序中使用 PDF 编辑库了。编码愉快!

请务必查阅您正在使用的 PDF 编辑库的官方文档，了解详细说明和示例。

安装 Node.js 和 IronPDF

要开始处理 PDF 文档，您需要一个正常运行的 Node.js 环境并安装 IronPDF 库。本节将指导您完成安装过程，确保您拥有开始 PDF 操作之旅的必要工具。

第 1 步：安装 Node.js

1.访问 Node.js 官方网站 nodejs.org.

2.为您的操作系统下载最新稳定版本的 Node.js。

3.运行安装程序并按照提示完成安装过程。

4.要验证 Node.js 安装是否正确，请打开终端或命令提示符并运行以下命令：

   node --version

您将看到 Node.js 的版本号打印到控制台。

第 2 步：安装 IronPDF

要安装 IronPDF 库，您有两个选择：

选项 1：使用 npm

1.打开终端或命令提示符。

2.导航至项目目录。

3.运行以下命令

   npm install ironpdf

方案 2：使用纱线

1.打开终端或命令提示符。

2.导航至项目目录。

3.运行以下命令

   yarn add ironpdf

第 3 步：验证安装

要验证 IronPDF 安装是否正确，可以创建一个简单的 Node.js 脚本，使用 IronPDF 执行基本操作，如生成 PDF 文件。下面是一个示例：

const IronPDF = require('ironpdf');

async function generatePdf() {
  const html = '<html><body><h1>Hello IronPDF!</h1></body></html>';

  const pdf = await IronPDF.Renderer.RenderHtmlAsPdf(html);

  await pdf.SaveAs('output.pdf');
}

generatePdf();

const IronPDF = require('ironpdf');

async function generatePdf() {
  const html = '<html><body><h1>Hello IronPDF!</h1></body></html>';

  const pdf = await IronPDF.Renderer.RenderHtmlAsPdf(html);

  await pdf.SaveAs('output.pdf');
}

generatePdf();

JAVASCRIPT

将上述代码保存到文件中 (例如，"生成-pdf.js)然后使用 Node.js 执行以下命令：

node generate-pdf.js

如果一切设置正确，你应该会在项目目录中看到一个名为 output.pdf 的新文件。

恭喜您! 现在您已经安装了 Node.js 和 IronPDF，可以开始处理 PDF 文档了。

分步安装指南

安装 Node.js：首先，从以下地址下载并安装 Node.js 官方网站.这也会安装 npm (节点软件包管理器)是管理 JavaScript 软件包的主要工具。
添加 IronPDF：安装 Node.js 后，使用 npm 安装 IronPDF。在命令行中运行 npm install ironpdf。

创建第一个 JavaScript 文件

环境设置完成后，就可以创建第一个 JavaScript 文件了。该文件将作为 PDF 操作任务的基础。您可以使用任何集成开发环境来创建 JavaScript 文件。

以下是创建 JavaScript 文件的步骤：

1.打开首选的集成开发环境 (IDE) 或文本编辑器。

2.创建一个新文件并以 .js 扩展名保存 (例如，"pdfManipulation.js).

3.在该文件中，您可以开始编写 JavaScript 代码，以执行所需的 PDF 操作任务。

例如，让我们定义一个在 PDF 上添加水印的函数：

function addWatermarkToPdf(pdfPath, watermarkText, outputPath) {
  // Code to add the watermark to the PDF
  // ...
}

// Example usage
const pdfPath = 'path/to/input.pdf';
const watermarkText = 'Confidential';
const outputPath = 'path/to/output.pdf';

addWatermarkToPdf(pdfPath, watermarkText, outputPath);

function addWatermarkToPdf(pdfPath, watermarkText, outputPath) {
  // Code to add the watermark to the PDF
  // ...
}

// Example usage
const pdfPath = 'path/to/input.pdf';
const watermarkText = 'Confidential';
const outputPath = 'path/to/output.pdf';

addWatermarkToPdf(pdfPath, watermarkText, outputPath);

JAVASCRIPT

请记住，将 pdfPath、watermarkText 和 outputPath 替换为您要使用的实际文件路径和水印文本。

写完代码后，您就可以保存文件，并开始在 Node.js 中运行或根据需要使用其他方法测试您的 PDF 操作函数。

编码愉快!

编辑 PDF：了解 IronPDF 功能

编辑 PDF 中的内容是最常见的任务之一。IronPDF 的编辑功能非常强大，允许在 PDF 文档中进行任何类型的修改。

密码、安全和元数据

IronPDF 不仅能确保 PDF 文档的安全性，还能通过适当的元数据对其进行良好的组织。设置密码是一个简单明了的过程，您还可以实施其他安全措施，包括限制打印、复制和编辑 PDF 文件。元数据在文档管理中起着至关重要的作用，它可以根据作者、标题和主题等属性更轻松地对 PDF 文档进行分类和检索。

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function securePDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    // Load the existing PDF document
    const pdf = await PdfDocument.fromFile("output.pdf");

    // Make PDF read-only
    await pdf.makePdfDocumentReadOnly("readonlypassword");

    // Configure permissions
    const permissions = {
      AllowAnnotations: false,
      AllowExtractContent: false,
      AllowFillForms: false,
      AllowPrint: true,
    };
    await pdf.setPermission(permissions);

    // Change or set the document encryption password
    await pdf.saveAs("securedPDF.pdf", { userPassword: "my-password" });
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function securePDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    // Load the existing PDF document
    const pdf = await PdfDocument.fromFile("output.pdf");

    // Make PDF read-only
    await pdf.makePdfDocumentReadOnly("readonlypassword");

    // Configure permissions
    const permissions = {
      AllowAnnotations: false,
      AllowExtractContent: false,
      AllowFillForms: false,
      AllowPrint: true,
    };
    await pdf.setPermission(permissions);

    // Change or set the document encryption password
    await pdf.saveAs("securedPDF.pdf", { userPassword: "my-password" });
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

JAVASCRIPT

如何在 Node.js 中编辑 PDF 文件：图 2 - 输出：使用 IronPDF 进行密码保护的 securedPDF.pdf

数字签名

IronPDF 支持数字签名，这对于商业交易中的验证和信任至关重要。该功能增加了一层验证，确认整个文档的来源和完整性。

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function signPDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    // Step 1. Import a PDF
    const pdf = await PdfDocument.open("output.pdf");

    // Step 2. Sign the PDF with digital certificate
    await pdf.signDigitalSignature({
      certificatePath: "DigitalIronSoftware.pfx",
      certificatePassword: "abcdedf",
      signingReason: "How to sign a PDF",
      signingLocation: "Chicago, USA",
      signatureImage: {
        SignatureImagePath: "logo.png",
      },
    });

    // Step 3. Save the Signed PDF
    await pdf.saveAs("signed.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function signPDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    // Step 1. Import a PDF
    const pdf = await PdfDocument.open("output.pdf");

    // Step 2. Sign the PDF with digital certificate
    await pdf.signDigitalSignature({
      certificatePath: "DigitalIronSoftware.pfx",
      certificatePassword: "abcdedf",
      signingReason: "How to sign a PDF",
      signingLocation: "Chicago, USA",
      signatureImage: {
        SignatureImagePath: "logo.png",
      },
    });

    // Step 3. Save the Signed PDF
    await pdf.saveAs("signed.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

JAVASCRIPT

PDF 压缩

使用 IronPDF，您可以缩小 PDF 文档的文件大小，使其更易于共享，并加快上传或下载速度。压缩是管理大量 PDF 文件的关键，尤其是在存储空间和带宽非常紧张的情况下。

// Load the existing PDF document
const pdf = await PdfDocument.fromFile("output.pdf");

// Compress images with quality parameter varies (1-100)
await pdf.compressSize(70);

// Save the compressed PDF
await pdf.saveAs("CompressedPDF.pdf");

// Load the existing PDF document
const pdf = await PdfDocument.fromFile("output.pdf");

// Compress images with quality parameter varies (1-100)
await pdf.compressSize(70);

// Save the compressed PDF
await pdf.saveAs("CompressedPDF.pdf");

JAVASCRIPT

合并两个或多个 PDF 文件

IronPDF 可将多个 PDF 文件合并为一个文档。这在合并报告或将多个文档合并为一个文件进行分发时尤其有用。

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function mergePDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    IronPdfGlobalConfig.setConfig(IronPdfConfig);

    const firstPDF = await PdfDocument.fromFile("firstPDF.pdf");
    const secondPDF = await PdfDocument.fromFile("secondPDF.pdf");

    // Merge the two PDF documents
    const merged = await PdfDocument.mergePdf([firstPDF, secondPDF]);

    // Save the merged PDF
    await merged.saveAs("Merged.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function mergePDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    IronPdfGlobalConfig.setConfig(IronPdfConfig);

    const firstPDF = await PdfDocument.fromFile("firstPDF.pdf");
    const secondPDF = await PdfDocument.fromFile("secondPDF.pdf");

    // Merge the two PDF documents
    const merged = await PdfDocument.mergePdf([firstPDF, secondPDF]);

    // Save the merged PDF
    await merged.saveAs("Merged.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

JAVASCRIPT

移除特定 PDF 页面

IronPDF 允许有选择性地删除现有 PDF 文件中的页面，使您能够根据特定需求或偏好准备文档。

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function removePages() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    IronPdfGlobalConfig.setConfig(IronPdfConfig);

    // Create a PDF document from the HTML
    const pdfDoc = await PdfDocument.fromFile("output.pdf");

    // Remove pages 2 and 3 (page numbers are zero-based)
    pdfDoc.removePage([1, 2]);

    // Save the modified PDF document
    await pdfDoc.saveAs("pageRemoved.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function removePages() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    IronPdfGlobalConfig.setConfig(IronPdfConfig);

    // Create a PDF document from the HTML
    const pdfDoc = await PdfDocument.fromFile("output.pdf");

    // Remove pages 2 and 3 (page numbers are zero-based)
    pdfDoc.removePage([1, 2]);

    // Save the modified PDF document
    await pdfDoc.saveAs("pageRemoved.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

JAVASCRIPT

在 PDF 文档中查找和替换文本

IronPDF 提供在 PDF 文档中搜索特定文本并替换的功能。这在更新信息或纠正 PDF 文件中的错误时尤其方便。

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function replaceTextInPDF() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    IronPdfGlobalConfig.setConfig(IronPdfConfig);

    // Load the PDF document
    const pdf = await PdfDocument.fromFile("input.pdf");

    // Parameters
    const pageIndex = 0; // Page index (zero-based)
    const oldText = "Old Text"; // Text to find
    const newText = "New Text"; // Text to replace

    // Replace text on the specified page
    await pdf.replaceText(oldText, newText, pageIndex);

    // Save the modified PDF document
    await pdf.saveAs("output.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function replaceTextInPDF() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    IronPdfGlobalConfig.setConfig(IronPdfConfig);

    // Load the PDF document
    const pdf = await PdfDocument.fromFile("input.pdf");

    // Parameters
    const pageIndex = 0; // Page index (zero-based)
    const oldText = "Old Text"; // Text to find
    const newText = "New Text"; // Text to replace

    // Replace text on the specified page
    await pdf.replaceText(oldText, newText, pageIndex);

    // Save the modified PDF document
    await pdf.saveAs("output.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

JAVASCRIPT

如何在 Node.js 中编辑 PDF 文件：图 3 - 输出：显示替换后文本 IronPDF Library for .NET7 的 replacedPDF.pdf

在 PDF 文件中印制新内容

使用 IronPDF 可以轻松地在 PDF 页面上添加新内容，如图像或文本。这可用于品牌推广、添加页眉、页脚、PNG 图像甚至水印。

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function stampPDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    IronPdfGlobalConfig.setConfig(IronPdfConfig);

    // Open existing PDF
    const pdfdoc = await PdfDocument.fromFile("output.pdf");

    // Configure the HTML stamp
    const stampOptions = {
      horizontalAlignment: "Center",
      verticalAlignment: "Bottom",
      behindExistingContent: false,
      opacity: 30,
    };

    const html = "<img src='logo.png'/>";

    // Apply the stamp to the PDF
    await pdfdoc.stampHtml(html, { htmlStampOptions: stampOptions });

    // Save the stamped PDF
    await pdfdoc.saveAs("stamped_image.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function stampPDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    IronPdfGlobalConfig.setConfig(IronPdfConfig);

    // Open existing PDF
    const pdfdoc = await PdfDocument.fromFile("output.pdf");

    // Configure the HTML stamp
    const stampOptions = {
      horizontalAlignment: "Center",
      verticalAlignment: "Bottom",
      behindExistingContent: false,
      opacity: 30,
    };

    const html = "<img src='logo.png'/>";

    // Apply the stamp to the PDF
    await pdfdoc.stampHtml(html, { htmlStampOptions: stampOptions });

    // Save the stamped PDF
    await pdfdoc.saveAs("stamped_image.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

JAVASCRIPT

如何在 Node.js 中编辑 PDF 文件：图 4 - 输出：使用 IronPDF 在 PDF 页面上印制新内容

PDF 表格

IronPDF 支持 PDF 表单的创建和操作，允许在文档中添加文本字段、复选框和单选按钮等交互式元素。用户可直接在 PDF 中填写表格，从而简化数据收集和分发流程。

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function createPDFsWithForms() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    IronPdfGlobalConfig.setConfig(IronPdfConfig);

    // Simplified HTML content with fewer form fields
    const formHtml = `
        <html>
            <body>
                <h2>Simple Registration Form</h2>
                <form>
                    Name: <br> 
                    Email: <br> 
                    <p>Age:</p>
                    <p>Favorite Color:</p>
                    <select name='color'>
                        <option value='Red'>Red</option>
                        <option value='Blue'>Blue</option>
                        <option value='Green'>Green</option>
                        <option value='Yellow'>Yellow</option>
                    </select>
                </form>
            </body>
        </html>
    `;

    // Use the same render options
    const options = {
      createPdfFormsFromHtml: true,
    };

    // Render HTML content to a PDF with editable forms
    const pdfdoc = await PdfDocument.fromHtml(formHtml, {
      renderOptions: options,
    });

    // Save the new PDF
    await pdfdoc.saveAs("simpleRegistrationForm.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

import { PdfDocument } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";

(async function createPDFsWithForms() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };

    IronPdfGlobalConfig.setConfig(IronPdfConfig);

    // Simplified HTML content with fewer form fields
    const formHtml = `
        <html>
            <body>
                <h2>Simple Registration Form</h2>
                <form>
                    Name: <br> 
                    Email: <br> 
                    <p>Age:</p>
                    <p>Favorite Color:</p>
                    <select name='color'>
                        <option value='Red'>Red</option>
                        <option value='Blue'>Blue</option>
                        <option value='Green'>Green</option>
                        <option value='Yellow'>Yellow</option>
                    </select>
                </form>
            </body>
        </html>
    `;

    // Use the same render options
    const options = {
      createPdfFormsFromHtml: true,
    };

    // Render HTML content to a PDF with editable forms
    const pdfdoc = await PdfDocument.fromHtml(formHtml, {
      renderOptions: options,
    });

    // Save the new PDF
    await pdfdoc.saveAs("simpleRegistrationForm.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

JAVASCRIPT

如何在 Node.js 中编辑 PDF 文件：图 5 - 输出：simpleRegistrationForm.pdf 文件

结论

IronPDF 是在 Node.js 中进行 PDF 操作的综合解决方案。IronPDF 具有从合并 PDF 到保护 PDF 的各种功能，可帮助开发人员有效管理 PDF 文档。无论手头的任务是编辑现有的 PDF 还是从头开始创建新的 PDF，IronPDF 都能提供必要的工具来高效、精确地完成这些任务。

IronPDF 提供免费试用版和各种许可选项，可全面使用 IronPDF 的所有功能。

如何在 Node.js 中编辑 PDF 文件：图 6 - IronPDF 许可证信息