如何在Node.js中将PDF转换为图像文件

如何安装 IronPDF for Node.js?

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

从npm安装IronPDF的Node.js包以将PDF转换为PNG、JPG、GIF、BMP和其他图像格式。

在生产中将PDF转换为图像之前，配置您的许可证密钥。 该包还需要在您的系统上安装IronPDF引擎——这个二进制文件处理所有PDF渲染操作，并必须存在以进行转换。

如何将 PDF 转换为图像？

rasterizeToImageFiles 方法读取 PDF 文档，并将每页内容写入您指定的输出路径中，生成一个图像文件。对于单页 PDF，该方法将生成恰好一个图像文件。 对于多页PDF，它会自动在每个文件名后追加页码后缀。

下面的示例加载一个来自Learning Container的示例PDF，并将其转换为PNG文件。

在查看器中打开的示例PDF文件。 从Learning Container下载此文件和其他测试PDF。

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-png.js
import { PdfDocument } from "@ironsoftware/ironpdf";

// Load the PDF and convert it to a PNG image.
// The output path determines the format — change .png to .jpg for JPEG output.
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/sample-pdf-file.png");
    return pdf;
}).catch((error) => {
    console.error("Error converting PDF to image:", error);
});

PdfDocument.fromFile 加载 PDF 并返回一个 Promise，该 Promise 解析为 PdfDocument 对象。 .then 回调函数接收已解析的文档，并使用目标路径调用 rasterizeToImageFiles。 路径中的文件扩展名（此处为 .png）用于告知 IronPDF 生成何种格式。 .catch 代码块用于处理任何读取或转换错误。

从上述示例PDF生成的PNG。 IronPDF仅用三行代码转换了文档。

有关此方法选项的更多详细示例，请参见PDF到图片代码示例页面。

如何将PDF转换为JPEG格式？

格式选择为自动模式：您传递给 rasterizeToImageFiles 的扩展名将决定输出格式。 要生成JPEG而不是PNG，请更改目标路径中的扩展名：

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-extension.js
// Switch to JPEG by changing the file extension in the output path.
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg");

当无法控制输出文件名时（例如在采用固定命名规则的自动化管道中），请在选项对象中传入 ImageType 值以覆盖基于扩展名的检测：

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-imagetype.js
import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// ImageType.JPG forces JPEG output regardless of the file extension.
const options = {
    type: ImageType.JPG,
    dpi: 300
};
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/output.png", options);
    return pdf;
});

选项对象中的 type 属性优先于文件名扩展名。 在上例中，即使目标路径以 .png 结尾，rasterizeToImageFiles 仍会生成一个 JPEG 文件。 相同的模式适用于GIF和BMP输出。

如何将多页PDF转换为图片？

对于多页文档，rasterizeToImageFiles 会为每页生成一张图片。 IronPDF在每个输出文件名后面追加基于零的页索引，使输出无需额外代码即可保持有序。

一个两页的示例PDF。 IronPDF在转换过程中为每页创建一个图像文件。

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-multipage.js
import { PdfDocument } from "@ironsoftware/ironpdf";

// Each page of the PDF becomes a separate image file.
// Output filenames: multipage-pdf-page_1.png, multipage-pdf-page_2.png, etc.
PdfDocument.fromFile("./multipage-pdf.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/multipage-pdf/multipage-pdf-page.png");
});

从两页PDF生成的两个PNG文件。 IronPDF使用其页码命名每个输出文件。

此自动页面分割行为适用于所有支持的图像格式。 结合下一节中的 fromPages 选项，可仅转换大型文档中的特定页面。 为了向相反方向操作，请查看图片到PDF示例以了解如何将多个图像文件合并成一个PDF文档。

如何只转换特定页面？

options 对象中的 fromPages 属性接受一个以零为起点的页面索引数组。 仅提指定的页面被栅格化； 所有其他页面被跳过。 这是处理大型PDF时很有用，只需部分页面时 — 例如，为文档预览提取封面和段落起始页面。 若需在转换前对单个页面进行操作，PdfDocument 的 Node.js API 参考文档中详细说明了其他页面级操作。

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-selective-pages.js
import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";

// Convert only pages 1, 4, 6, and 9 (zero-indexed: 0, 3, 5, 8) to BMP.
const options = {
    type: ImageType.BMP,
    fromPages: [0, 3, 5, 8],
    dpi: 150
};
PdfDocument.fromFile("./sample-pdf-with-images.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles(
        "./images/multipage-selective-pdf/multipage-pdf-page.bmp",
        options
    );
}).catch((error) => {
    console.error("Failed to convert pages:", error);
});

IronPDF 仅对 fromPages 数组中指定的四页进行了光栅化处理。 其他页面未处理。

fromPages 中的页码采用从零开始的计数方式，因此 [0, 3, 5, 8] 对应的是第 1、4、6 和 9 页。 150的DPI值在输出质量与文件大小之间取得了平衡 — 适合归档或预览用例。 选择性转换适用于所有已支持的图像类型。

PDF到图像转换的下一步是什么？

IronPDF 的 rasterizeToImageFiles 方法通过统一的 API 处理格式选择、多页拆分以及选定页面的转换。 选项对象是格式覆盖、DPI控制和页面过滤的唯一扩展点。

此外，IronPDF for Node.js API 参考文档详细记录了 rasterizeToImageFiles 和 PdfDocument 类中所有可用的参数。 PDF 转图像的代码示例展示了 rasterizeToImageFiles 配合额外配置的使用方式。 为了相反方向的操作，请查看图片到PDF文件转换或多帧TIFF文件到PDF转换。

开始IronPDF for Node.js的免费试用，以在您自己的项目中测试PDF到图像的转换。 查看许可选项以找到适合您团队的计划。

准备看看IronPDF还能做些什么吗？ 在此查看完整的Node.js教程：Node.js中的HTML到PDF转换