Wie wandle ich ein PDF in eine Bilddatei in Node.js um

Wie installiere ich IronPDF for Node.js?

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

Installieren Sie das Node.js-Paket von IronPDF über npm, um PDFs in PNG, JPG, GIF, BMP und andere Bildformate zu konvertieren.

Bevor Sie PDFs in der Produktion in Bilder umwandeln, konfigurieren Sie Ihren Lizenzschlüssel. Das Paket erfordert außerdem, dass die IronPDF-Engine auf Ihrem System installiert ist — dieses Binary führt alle PDF-Darstellungsoperationen durch und muss vorhanden sein, damit die Konvertierung funktioniert.

Wie konvertiere ich ein PDF in ein Bild?

Die Methode rasterizeToImageFiles liest ein PDF-Dokument und schreibt eine Bilddatei pro Seite in den von Ihnen angegebenen Ausgabepfad. Bei einseitigen PDFs erzeugt sie genau ein Bild. Bei mehrseitigen PDFs wird automatisch ein Seitenzahlensuffix an jeden Dateinamen angehängt.

Das untenstehende Beispiel lädt ein Beispiel-PDF von Learning Container und konvertiert es in eine PNG-Datei.

Die Beispiel-PDF-Datei in einem Betrachter geöffnet. Laden Sie diese Datei und andere Test-PDFs von Learning Container herunter.

//: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 lädt die PDF-Datei und gibt ein Promise zurück, das zu einem PdfDocument-Objekt aufgelöst wird. Der .then-Callback empfängt das aufgelöste Dokument und ruft rasterizeToImageFiles mit dem Zielpfad auf. Die Dateiendung im Pfad – hier .png – teilt IronPDF mit, welches Format erzeugt werden soll. Der Block .catch behandelt alle Lese- oder Konvertierungsfehler.

Das aus dem obigen Beispiel-PDF erstellte PNG. IronPDF konvertiert das Dokument mit drei Codezeilen.

Für detailliertere Beispiele zu den Optionen dieser Methode siehe die PDF zu Bildern Codebeispielseite.

Wie wandelt man ein PDF in das JPEG-Format um?

Die Formatauswahl erfolgt automatisch: Die an rasterizeToImageFiles übergebene Erweiterung bestimmt das Ausgabeformat. Um ein JPEG statt eines PNG zu erzeugen, ändern Sie die Erweiterung im Zielpfad:

//: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");

Wenn der Name der Ausgabedatei nicht gesteuert werden kann – beispielsweise in automatisierten Pipelines mit festen Namensschemata – übergeben Sie einen Wert von ImageType im Optionsobjekt, um die auf der Dateiendung basierende Erkennung zu überschreiben:

//: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;
});

Die Eigenschaft type im Optionsobjekt hat Vorrang vor der Dateinamenerweiterung. Im obigen Beispiel erzeugt rasterizeToImageFiles eine JPEG-Datei, obwohl der Zielpfad mit .png endet. Das gleiche Muster gilt für GIF- und BMP-Ausgaben.

Wie wandelt man ein mehrseitiges PDF in Bilder um?

Bei mehrseitigen Dokumenten erstellt rasterizeToImageFiles ein Bild pro Seite. IronPDF hängt einen nullbasierten Seitenindex an jeden Ausgabedateinamen an, sodass die Ausgabe organisiert bleibt, ohne dass zusätzlicher Code erforderlich ist.

Ein zweiseitiges Beispiel-PDF. IronPDF erstellt während der Konvertierung eine Bilddatei pro Seite.

//: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");
});

Die zwei PNG-Dateien, die aus dem zweiseitigen PDF erstellt wurden. IronPDF benennt jede Ausgabedatei mit der Seitennummer.

Dieses automatische Seitenteilungsverhalten funktioniert mit allen unterstützten Bildformaten. Kombinieren Sie dies mit der Option fromPages im nächsten Abschnitt, um nur bestimmte Seiten aus umfangreichen Dokumenten zu konvertieren. Um in die entgegengesetzte Richtung zu arbeiten, zeigt das Beispiel Bild zu PDF, wie mehrere Bilddateien zu einem einzigen PDF-Dokument zusammengefügt werden.

Wie konvertiere ich nur bestimmte Seiten?

Die Eigenschaft fromPages im Options-Objekt akzeptiert ein Array von Seitenindizes, beginnend bei Null. Nur die angegebenen Seiten werden gerastert; alle anderen werden übersprungen. Dies ist nützlich beim Arbeiten mit großen PDFs, wo nur eine Teilmenge von Seiten benötigt wird — beispielsweise das Extrahieren von Titel- und Kapitelnanfangsseiten für eine Dokumentenvorschau. Wenn Sie vor der Konvertierung mit einzelnen Seiten arbeiten müssen, dokumentiert die Node.js-API Referenz für PdfDocument zusätzliche Operationen auf Seitenebene.

//: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 hat nur die vier Seiten gerastert, die im Array fromPages angegeben waren. Die anderen Seiten wurden nicht verarbeitet.

Die Seitenindizes in fromPages sind nullbasiert, sodass [0, 3, 5, 8] auf die erste, vierte, sechste und neunte Seite verweist. Der DPI-Wert von 150 balanciert die Ausgabequalität gegenüber der Dateigröße – geeignet für Archivierungs- oder Vorschauanwendungsfälle. Selective Konvertierung ist kompatibel mit allen unterstützten Bildtypen.

Was sind die nächsten Schritte zur PDF-zu-Bild-Konvertierung?

Die rasterizeToImageFiles-Methode von IronPDF ermöglicht die Formatauswahl, das Aufteilen mehrseitiger Dokumente und die selektive Seitenkonvertierung über eine einheitliche API. Das Optionsobjekt ist der einzige Erweiterungspunkt für Formatüberschreibungen, DPI-Steuerung und Seitenfilterung.

Darüber hinaus dokumentiert die IronPDF for Node.js-API Referenz alle Parameter, die für rasterizeToImageFiles und die Klasse PdfDocument verfügbar sind. Das Code-Beispiel "PDF to Images" zeigt die Verwendung von rasterizeToImageFiles mit zusätzlicher Konfiguration. Um in die entgegengesetzte Richtung zu arbeiten, siehe Bilder zu PDF-Dateien konvertieren oder mehrseitige TIFF-Dateien zu PDF konvertieren.

Starten Sie Ihre kostenlose Testversion von IronPDF for Node.js, um die PDF-zu-Bild-Konvertierung in Ihrem eigenen Projekt zu testen. Sehen Sie sich die Lizenzierungsmöglichkeiten an, um den Plan zu finden, der zu Ihrem Team passt.

Bereit zu sehen, was IronPDF sonst noch kann? Sehen Sie sich das vollständige Node.js-Tutorial hier an: HTML zu PDF in Node.js