Comment convertir un PDF en fichier image en Node.js

Comment convertir un PDF en fichier image dans Node.js

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF for Node.js convertit les pages PDF en images avec un seul appel de méthode. La méthode rasterizeToImageFiles produit des formats PNG, JPG, GIF, BMP, et autres à partir de n'importe quel PDF — mono-page ou multi-page — avec un contrôle direct sur la résolution de sortie et la sélection de pages.

La méthode détecte automatiquement le format de sortie à partir de l'extension de fichier que vous fournissez, donc passer d'un format à l'autre ne nécessite aucune modification de configuration. Pour les environnements où l'extension ne peut pas être modifiée, une valeur d'énumération explicite ImageType remplace la détection basée sur l'extension. La documentation IronPDF for Node.js couvre toute la gamme des sources d'entrée prises en charge, y compris les chemins de fichiers, les buffers octets, et les chaînes HTML converties en PDF avant rasterisation.

Démarrage rapide : Convertir PDF en PNG

  1. Installez IronPDF : npm install @ironsoftware/ironpdf
  2. Importez PdfDocument depuis le paquet
  3. Chargez votre PDF avec PdfDocument.fromFile()
  4. Appelez rasterizeToImageFiles() avec le chemin de sortie
:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/quickstart.js

Comment installer IronPDF for Node.js?

 npm i @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.

Quelle est la configuration requise?

Node.js 12 ou ultérieur est requis. Le binaire du moteur IronPDF est téléchargé automatiquement la première fois que le package se charge, mais vous pouvez également l'installer manuellement si votre environnement de déploiement restreint l'accès réseau sortant. Le paquet @ironsoftware/ironpdf est disponible sur le registre npm et ne comporte aucune étape de compilation de module natif, ce qui maintient les pipelines CI simples.

Veuillez noterUne clé de licence n'est pas requise pendant le développement. Une sortie avec filigrane est produite en mode non licencié. Les filigranes sont supprimés dès qu'une clé valide est configurée.

Comment convertir un PDF en image?

La méthode rasterizeToImageFiles lit un document PDF et écrit un fichier image par page sur le chemin de sortie que vous fournissez. Pour les PDFs à 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.

Visionneuse PDF montrant un document d'exemple Lorem Ipsum d'une page utilisé en entrée avant la conversion PDF en image 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

PdfDocument.fromFile charge le PDF et retourne une Promesse résolue en un objet PdfDocument. Le rappel .then reçoit le document résolu et appelle rasterizeToImageFiles avec le chemin de destination. L'extension de fichier dans le chemin — .png ici — indique à IronPDF quel format produire. Le bloc .catch gère toutes les erreurs de lecture ou de conversion.

Fichier de sortie PNG converti montrant le contenu du document Lorem Ipsum rendu comme une image PNG 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 des formats est automatique : quelle que soit l'extension que vous passez à rasterizeToImageFiles, celle-ci 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 de 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 d'options pour contourner 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

La propriété type dans l'objet d'options prime sur l'extension de nom de fichier. Dans l'exemple ci-dessus, rasterizeToImageFiles produit 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 les paramètres DPI affectent-ils la qualité de sortie ?

La propriété dpi dans l'objet d'options contrôle la densité de pixels de la sortie rasterisée. Des valeurs plus élevées produisent des fichiers plus grands avec plus de détails ; des valeurs inférieures réduisent la taille du fichier aux dépens de la netteté.

Réglage de dpi: 300 produit des images de qualité d'impression adaptées à l'impression haute résolution ou à l'archivage. Pour l'affichage sur écran ou la génération de vignettes, dpi: 96 réduit la taille du fichier tout en maintenant une clarté adéquate pour une utilisation web.

Un DPI de 150 est un défaut raisonnable pour la plupart des scénarios d'archivage ou d'aperçu — la sortie est suffisamment nette pour la lecture à l'écran et les tailles de fichiers restent gérables. Pour le contenu qui sera imprimé ou soumis à un traitement OCR après conversion, un DPI de 300 ou plus est préférable.

Icon Quote related to Comment les paramètres DPI affectent-ils la qualité de sortie ?

Ma bibliothèque préférée de ce genre est IronPDF. Elle permet une manipulation rapide et efficace des fichiers PDF. Elle dispose également de nombreuses fonctionnalités précieuses, comme l'exportation au format PDF/A et la signature numérique des documents PDF.

Milan Jovanovic related to Comment les paramètres DPI affectent-ils la qualité de sortie ?

Milan Jovanovic

Microsoft MVP

Voir l'étude de cas
Icon Quote related to Comment les paramètres DPI affectent-ils la qualité de sortie ?

IronOCR signifie que nous pouvons économiser 40 000 $ par an grâce au traitement manuel, tout en améliorant la productivité et en libérant des ressources pour des tâches à fort impact. Je le recommande vivement.

Brent Matzelle related to Comment les paramètres DPI affectent-ils la qualité de sortie ?

Brent Matzelle

Directeur technique, OPYN

Voir l'étude de cas
Icon Quote related to Comment les paramètres DPI affectent-ils la qualité de sortie ?

Iron Suite joue un rôle crucial dans nos opérations. Ce sont des outils qui augmentent l'efficacité de l'entreprise, y compris la création de plans d'étage et l'amélioration de la gestion des stocks.

David Jones related to Comment les paramètres DPI affectent-ils la qualité de sortie ?

David Jones

Ingénieur logiciel principal, Agorus Build

Voir l'étude de cas

Comment convertir un PDF multi-pages en images ?

Pour les documents avec 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 document PDF de deux pages ouvert dans une visionneuse, montrant deux pages de contenu d'exemple avant la conversion en image 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

Deux fichiers de sortie PNG — multipage-pdf-page_1.png et multipage-pdf-page_2.png — créés à partir du PDF de deux pages ci-dessus 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-le à l'option fromPages dans la section suivante pour convertir uniquement des pages spécifiques de grands documents. Pour travailler dans la direction opposée, l'exemple image vers PDF montre comment combiner plusieurs fichiers image en un seul document PDF.

Comment sont structurés les noms de fichiers de sortie ?

Le modèle de nom de fichier utilise un numéro de page basé sur un, ajouté avant l'extension de fichier. Si le chemin de sortie est ./images/report-page.png, un PDF de trois pages produira report-page_1.png, report-page_2.png, et report-page_3.png. Le répertoire de sortie doit exister avant d'appeler rasterizeToImageFiles — la méthode ne crée pas les répertoires manquants automatiquement.

Créez le répertoire de sortie avant d'appeler rasterizeToImageFiles. La méthode lève une erreur si le répertoire cible n'existe pas. Utilisez fs.mkdirSync('./images/output', { recursive: true }) de Node.js pour le créer à l'avance.

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

La propriété fromPages dans l'objet d'options accepte un tableau d'indices de page basés sur 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 avec des pages individuelles avant de les convertir, la référence d'API Node.js pour PdfDocument documente des opérations additionnelles au niveau des pages.

:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-selective-pages.js

Quatre fichiers de sortie BMP étiquetés multipage-pdf-page_1, page_4, page_7 et page_9 produits à partir d'un grand PDF IronPDF a rasterisé uniquement les quatre pages spécifiées dans le tableau fromPages. Les autres pages n'ont pas été traitées.**

Les indices de page dans fromPages sont basés sur zéro, donc [0, 3, 5, 8] cible la première, la quatrième, la sixième et la 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.

Veuillez noterTéléchargez le PDF d'exemple avec des images utilisé dans l'exemple ci-dessus depuis Learning Container.

Quelle est la différence entre des numéros de page basés sur zéro et sur un ?

fromPages utilise l'indexation basée sur zéro, correspondant à la convention standard des tableaux JavaScript. La page 1 du document correspond à l'index 0, la page 2 à l'index 1, et ainsi de suite. Cela diffère des numéros de page basés sur un qui apparaissent dans les visionneuses de PDF. Lorsque vous traduisez les numéros de page du visualiseur en indices fromPages, soustrayez un à chaque numéro de page.

Pour convertir la dernière page de n'importe quel PDF sans connaître le nombre total de pages à l'avance, lisez le nombre de pages en utilisant pdf.pageCount() depuis l'API PdfDocument et utilisez [pdf.pageCount() - 1] comme valeur fromPages.

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

La méthode rasterizeToImageFiles d'IronPDF gère la sélection des formats, le fractionnement multi-pages et la conversion de pages sélectives dans 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 référence API Node.js d'IronPDF documente tous les paramètres disponibles sur rasterizeToImageFiles et la classe PdfDocument. L'exemple de code PDF en Images montre rasterizeToImageFiles utilisé avec une configuration additionnelle. 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

Questions Fréquemment Posées

Comment convertir un PDF en image dans Node.js ?

Utilisez la méthode rasterizeToImageFiles d'IronPDF. Installez le package avec npm install @ironsoftware/ironpdf, chargez votre PDF en utilisant PdfDocument.fromFile(), puis appelez rasterizeToImageFiles() avec le chemin de sortie. L'extension de fichier détermine automatiquement le format de sortie.

Quels formats d'image sont pris en charge par rasterizeToImageFiles ?

IronPDF prend en charge la sortie PNG, JPG, GIF et BMP. Le format est détecté à partir de l'extension de fichier dans le chemin de sortie. Pour remplacer cela, passez une valeur d'enum ImageType dans l'objet options : par exemple, { type: ImageType.JPG } force la sortie en JPEG indépendamment de l'extension du nom de fichier.

Comment convertir uniquement des pages spécifiques d'un PDF en images ?

Passez un tableau fromPages dans l'objet options. Le tableau accepte des indices de page basés sur zéro, donc fromPages: [0, 2, 4] convertit la première, la troisième et la cinquième page. Les pages non listées dans le tableau sont ignorées.

Quel DPI dois-je utiliser pour la conversion de PDF en image ?

Définissez la propriété dpi dans l'objet options. Utilisez dpi: 96 pour l'affichage à l'écran et les vignettes, dpi: 150 pour les cas d'utilisation d'archivage et de prévisualisation, et dpi: 300 pour une sortie de qualité impression ou du contenu qui sera traité par OCR après conversion.

Quelles sont les exigences d'installation pour IronPDF dans Node.js ?

Node.js 12 ou version ultérieure est requis. Installez le package avec npm install @ironsoftware/ironpdf. Le binaire IronPDF Engine se télécharge automatiquement lors de la première utilisation et gère tout le rendu PDF. Pour une utilisation en production, configurez une clé de licence pour supprimer les filigranes de la sortie.

Comment sont structurés les noms de fichiers de sortie pour les PDF multi-pages ?

IronPDF ajoute un numéro de page basé sur un à la fin de l'extension de fichier. Si le chemin de sortie est report-page.png, un PDF de trois pages produira report-page_1.png, report-page_2.png, et report-page_3.png. Le répertoire de sortie doit exister avant d'appeler la méthode.

La conversion de PDF en image est-elle asynchrone dans Node.js ?

Oui. Les méthodes PdfDocument.fromFile() et rasterizeToImageFiles() renvoient des Promises. Enchaînez .then() pour le chemin du succès et .catch() pour gérer les erreurs de conversion. Vous pouvez également utiliser la syntaxe async/await avec ces méthodes.

Darrius Serrant
Ingénieur logiciel Full Stack (WebOps)

Darrius Serrant est titulaire d'un baccalauréat en informatique de l'université de Miami et travaille comme ingénieur marketing WebOps Full Stack chez Iron Software. Attiré par le codage dès son plus jeune âge, il a vu l'informatique comme à la fois mystérieuse et accessible, en faisant le ...

Lire la suite
Prêt à commencer?
Version : 2026.6 vient de sortir
Still Scrolling Icon

Vous faites encore défiler ?

Vous voulez une preuve rapidement ?
exécuter un échantillon Regardez votre code HTML se transformer en PDF.