Comment convertir un PDF en fichier image dans Node.js

Comment installer IronPDF for Node.js?

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

Installez le package Node.js de IronPDF depuis npm pour convertir des PDF en PNG, JPG, GIF, BMP et autres formats d'image.

Avant de convertir des PDF en images en production, configurez votre clé de licence. Le package nécessite également que le moteur IronPDF soit installé sur votre système – ce binaire gère toutes les opérations de rendu des PDF et doit être présent pour que la conversion fonctionne.

Comment convertir un PDF en image?

La méthode rasterizeToImageFiles lit un document PDF et écrit un fichier image par page dans le chemin de sortie que vous indiquez. Pour les PDF d'une seule page, elle produit exactement une image. Pour les PDFs multi-pages, il ajoute automatiquement un suffixe de numéro de page à chaque nom de fichier.

L'exemple ci-dessous charge un PDF d'exemple de Learning Container et le convertit en fichier PNG.

Le fichier PDF d'exemple ouvert dans une visionneuse. Téléchargez ce fichier et d'autres PDFs de test depuis Learning Container.

//: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 charge le PDF et renvoie une Promise se résolvant en un objet PdfDocument. La fonction de rappel .then reçoit le document résolu et appelle rasterizeToImageFiles avec le chemin de destination. L'extension de fichier dans le chemin d'accès — .png ici — indique à IronPDF quel format produire. Le bloc .catch gère toutes les erreurs de lecture ou de conversion.

Le PNG généré à partir du PDF d'exemple ci-dessus. IronPDF convertit le document en trois lignes de code.

Pour des exemples plus détaillés des options de cette méthode, consultez la page d'exemples de code PDF en Images.

Comment convertir un PDF au format JPEG ?

La sélection du format est automatique : l'extension que vous transmettez à rasterizeToImageFiles détermine le format de sortie. Pour produire un JPEG à la place d'un PNG, changez l'extension dans le chemin de destination :

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

Lorsque le nom du fichier de sortie ne peut pas être contrôlé — par exemple, dans des pipelines automatisés avec des schémas de nommage fixes —, passez une valeur ImageType dans l'objet options pour remplacer la détection basée sur l'extension :

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

La propriété type de l'objet options a priorité sur l'extension du nom de fichier. Dans l'exemple ci-dessus, rasterizeToImageFiles génère un fichier JPEG même si le chemin de destination se termine par .png. Le même modèle s'applique aux sorties GIF et BMP.

Comment convertir un PDF multi-pages en images ?

Pour les documents de plus d'une page, rasterizeToImageFiles crée une image par page. IronPDF ajoute un indice de page basé sur zéro à chaque nom de fichier de sortie, gardant la sortie organisée sans code supplémentaire de votre part.

Un PDF d'exemple de deux pages. IronPDF crée un fichier image par page lors de la conversion.

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

Les deux fichiers PNG produits à partir du PDF de deux pages. IronPDF nomme chaque fichier de sortie avec son numéro de page.

Ce comportement de séparation automatique des pages fonctionne avec tous les formats d'image pris en charge. Associez-la à l'option fromPages de la section suivante pour convertir uniquement des pages spécifiques de documents volumineux. Pour travailler dans la direction opposée, l'exemple image vers PDF montre comment combiner plusieurs fichiers image en un seul document PDF.

Comment puis-je convertir uniquement des pages spécifiques ?

La propriété fromPages de l'objet options accepte un tableau d'index de pages à partir de zéro. Seules les pages spécifiées sont rasterisées ; toutes les autres sont ignorées. C'est utile lorsque vous travaillez avec de grands PDFs où seul un sous-ensemble de pages est nécessaire — par exemple, extraire la page de couverture et les pages de début de section pour un aperçu du document. Lorsque vous devez travailler sur des pages individuelles avant de les convertir, la référence de l'API Node.js pour PdfDocument documente des opérations supplémentaires au niveau de la page.

//: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 n'a rasterisé que les quatre pages spécifiées dans le tableau fromPages. Les autres pages n'ont pas été traitées.

Les index de page dans fromPages sont numérotés à partir de zéro, donc [0, 3, 5, 8] correspond aux première, quatrième, sixième et neuvième pages. La valeur DPI de 150 équilibre la qualité de sortie par rapport à la taille du fichier — adaptée pour des cas d'archivage ou d'aperçu. La conversion sélective est compatible avec tous les types d'images pris en charge.

Quelles sont les prochaines étapes pour la conversion PDF en image ?

La méthode rasterizeToImageFiles d'IronPDF gère la sélection du format, le fractionnement en plusieurs pages et la conversion sélective de pages au sein d'une API cohérente. L'objet options est le seul point d'extension pour les changements de format, le contrôle DPI, et le filtrage des pages.

Pour aller plus loin, la documentation de référence de l'API IronPDF for Node.js répertorie tous les paramètres disponibles sur rasterizeToImageFiles et la classe PdfDocument. L'exemple de code PDF vers images montre l'utilisation de rasterizeToImageFiles avec une configuration supplémentaire. Pour travailler dans le sens inverse, voir la conversion d'images en fichiers PDF ou la conversion de fichiers TIFF multi-images en PDF.

Commencez votre essai gratuit de IronPDF for Node.js pour tester la conversion PDF en image dans votre propre projet. Voir les options de licence pour trouver le plan qui convient à votre équipe.

Prêt à voir ce qu'IronPDF peut faire d'autre ? Consultez le tutoriel complet Node.js ici : HTML to PDF in Node.js