UTILISER IRONPDF POUR NODE.JS

Comment générer un fichier PDF en Node.js

Cet article s'efforce d'explorer en profondeur les nuances complexes de IronPDF, guidant les lecteurs à travers chaque facette depuis le processus d'installation initial jusqu'à sa mise en œuvre pratique dans des scénarios du monde réel.

1. Comment utiliser Node.js PDF Generator ?

  1. Installez la bibliothèque de génération de PDF IronPDF pour Node.js.

  2. Importer les dépendances requises.

  3. Rendre HTML en PDF en utilisant la fonction PdfDocument.fromHtml.

  4. Générez un PDF à partir d'une URL en utilisant la méthode PdfDocument.fromUrl.

  5. Convertissez des images en fichiers PDF en utilisant la méthode imageToPdf.

  6. Enregistrez les fichiers PDF créés en utilisant la méthode saveAs.

2. Exploration d'IronPDF pour Node.js

IronPDF d'Iron Software se présente comme une bibliothèque PDF redoutable méticuleusement conçue pour Node.js, dotant les développeurs de la capacité fluide de générer sans effort des fichiers PDF. Affichant une vaste gamme de fonctionnalités, IronPDF prouve sa polyvalence, répondant à un éventail de cas d'utilisation allant de la génération de documents et de la création de rapports à la création de contenu. Parmi ses attributs les plus remarquables, citons la remarquable capacité à convertir de manière transparente un modèle HTML et des images en fichiers PDF, ce qui témoigne de l'adaptabilité et de l'efficacité de la bibliothèque dans la gestion de diverses sources de contenu.

2.1. Installation d'IronPDF

Avant de plonger dans le monde de la génération de PDF, vous devez installer IronPDF. Le processus est simple, grâce à npm, le gestionnaire de paquets de Node.js. Ouvrez votre terminal et exécutez la commande suivante :

npm i @ironsoftware/ironpdf
npm i @ironsoftware/ironpdf
SHELL

Cette commande récupère et installe le paquetage IronPDF, le rendant disponible pour une utilisation dans votre projet Node.js.

Pour installer le moteur IronPDF nécessaire à l'utilisation de la bibliothèque IronPDF, exécutez la commande suivante sur la console.

npm install @ironsoftware/ironpdf-engine-windows-x64
npm install @ironsoftware/ironpdf-engine-windows-x64
SHELL

3. Ajout des paquets requis

Une fois IronPDF installé, vous devez inclure les paquets nécessaires dans votre projet à l'aide de l'instruction import. Cela vous garantit l'accès aux fonctionnalités fournies par IronPDF. Prenons l'exemple suivant :

import { PdfDocument } from "@ironsoftware/ironpdf";
import { PdfDocument } from "@ironsoftware/ironpdf";
NODE.JS

Cette déclaration d'importation intègre la classe PdfDocument, un élément fondamental pour générer des fichiers PDF avec IronPDF.

4. Générer des fichiers PDF

Maintenant qu'IronPDF est installé dans votre projet, explorons le processus de base de la génération d'un fichier PDF à l'aide du package PDF creator. Il existe de nombreuses façons de créer des fichiers PDF à l'aide d'IronPDF, mais cet article n'en abordera que quelques-unes.

  1. Chaîne HTML vers PDF

  2. URL vers PDF

  3. Images au format PDF

4.1. Convertir un document HTML en PDF à l'aide d'IronPDF

L'une des caractéristiques les plus remarquables d'IronPDF est sa capacité à convertir sans effort des fichiers HTML en fichiers PDF. Ceci est particulièrement utile lorsque vous avez du contenu dynamique généré sur le serveur et que vous souhaitez le présenter au format PDF. Voici un exemple simple :

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

(async () => {
  // Create a PDF from an HTML string
  const pdf = await PdfDocument.fromHtml("<h1>Hello Developers This is an Example PDF created with IronPDF</h1>");

  // Export the PDF to a file
  await pdf.saveAs("output.pdf");
})();
import { PdfDocument } from "@ironsoftware/ironpdf";

(async () => {
  // Create a PDF from an HTML string
  const pdf = await PdfDocument.fromHtml("<h1>Hello Developers This is an Example PDF created with IronPDF</h1>");

  // Export the PDF to a file
  await pdf.saveAs("output.pdf");
})();
NODE.JS

Ce fragment de code utilise IronPDF, une bibliothèque Node.js, pour générer dynamiquement un document PDF à partir d'une chaîne HTML spécifiée. Il commence par importer la classe PdfDocument du package IronPDF. La fonction asynchrone suivante utilise la méthode fromHtml pour créer un document PDF, en utilisant un simple élément de titre dans cet exemple. La méthode saveAs est ensuite utilisée pour exporter le PDF généré vers un fichier nommé "output.pdf".

La nature asynchrone du code est gérée grâce à l'utilisation de la syntaxe async/await, garantissant que les processus de génération et de sauvegarde des données PDF se déroulent de manière non bloquante. Dans l'ensemble, cet exemple succinct montre comment IronPDF rationalise la création et la manipulation des PDF dans un environnement Node.js.

Sortie

Comment générer un fichier PDF en Node.js, Figure 1 : PDF de sortie généré à partir d'une chaîne HTML en utilisant la bibliothèque IronPDF

PDF de sortie généré à partir d'une chaîne HTML en utilisant la bibliothèque IronPDF

4.2. Créer des fichiers PDF à partir d'une URL avec IronPDF

La création de fichiers PDF à partir d'une URL à l'aide d'IronPDF for Node.js est une fonctionnalité puissante qui vous permet de convertir du contenu web en documents PDF de manière programmatique. Voici un exemple de code qui montre comment y parvenir :

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

(async () => {
  // URL of the web page to convert to PDF
  const url = "https://google.com";

  // Create a PDF doc from the specified URL
  const pdf = await PdfDocument.fromUrl(url);

  // Save the PDF to a file
  await pdf.saveAs("output_from_url.pdf");
})();
import { PdfDocument } from "@ironsoftware/ironpdf";

(async () => {
  // URL of the web page to convert to PDF
  const url = "https://google.com";

  // Create a PDF doc from the specified URL
  const pdf = await PdfDocument.fromUrl(url);

  // Save the PDF to a file
  await pdf.saveAs("output_from_url.pdf");
})();
NODE.JS

Dans ce code :

  1. La classe PdfDocument est importée du package IronPDF.

  2. À l'intérieur d'une fonction asynchrone (enveloppée dans une expression de fonction invoquée immédiatement), une variable url est définie avec l'URL de la page web que vous souhaitez convertir en PDF.

  3. La méthode fromUrl est ensuite utilisée pour créer un document PDF à partir de l'URL spécifiée. IronPDF récupère le contenu de l'URL et le convertit en document PDF.

  4. Enfin, la méthode saveAs est utilisée pour enregistrer le PDF généré dans un fichier nommé "output_from_url.pdf".

    Cet exemple illustre la simplicité d'utilisation d'IronPDF pour convertir le contenu web d'une URL en fichier PDF, ce qui en fait un outil précieux pour les scénarios dans lesquels un contenu web dynamique doit être archivé ou partagé au format PDF.

    Comment générer un fichier PDF dans Node.js, Figure 2 : PDF généré à partir d'une URL en utilisant la bibliothèque IronPDF

    PDF de sortie généré à partir d'une URL en utilisant la bibliothèque IronPDF

4.3. Générer un fichier PDF à partir d'images à l'aide d'IronPDF

Outre le HTML, IronPDF permet de générer des fichiers PDF à partir d'images. Cette fonction est particulièrement utile lorsqu'il s'agit de compiler des images dans un seul document PDF. Prenons un exemple simple :

import { PdfGenerator } from "@ironsoftware/ironpdf";
import fs from 'fs';

(async () => {
  // Specify the directory path
  const directoryPath = './images';

  // Read the contents of the directory
  fs.readdir(directoryPath, (err, files) => {
    if (err) {
      console.error('Error reading directory:', err);
      return;
    }

    // Filter file names to include only .jpg and .jpeg extensions
    const jpegFiles = files.filter((file) =>
      file.toLowerCase().endsWith('.jpg') 
 file.toLowerCase().endsWith('.jpeg')
    );

    // Construct full file paths for the filtered files
    const filePaths = jpegFiles.map((file) => `${directoryPath}/${file}`);

    // Converts the images to a PDF and save it.
    const pdf = PdfGenerator.imageToPdf(filePaths).then(
      (returnedPdf) => {
        returnedPdf.saveAs("composite.pdf");
      });

    // Also see PdfDocument.rasterizeToImageFiles() method to flatten a PDF to images or thumbnails
  });
})();
import { PdfGenerator } from "@ironsoftware/ironpdf";
import fs from 'fs';

(async () => {
  // Specify the directory path
  const directoryPath = './images';

  // Read the contents of the directory
  fs.readdir(directoryPath, (err, files) => {
    if (err) {
      console.error('Error reading directory:', err);
      return;
    }

    // Filter file names to include only .jpg and .jpeg extensions
    const jpegFiles = files.filter((file) =>
      file.toLowerCase().endsWith('.jpg') 
 file.toLowerCase().endsWith('.jpeg')
    );

    // Construct full file paths for the filtered files
    const filePaths = jpegFiles.map((file) => `${directoryPath}/${file}`);

    // Converts the images to a PDF and save it.
    const pdf = PdfGenerator.imageToPdf(filePaths).then(
      (returnedPdf) => {
        returnedPdf.saveAs("composite.pdf");
      });

    // Also see PdfDocument.rasterizeToImageFiles() method to flatten a PDF to images or thumbnails
  });
})();
NODE.JS

Ce code utilise IronPDF, une bibliothèque Node.js, pour convertir une collection d'images JPEG dans un répertoire spécifié en un seul document PDF. Initialement, le code spécifie le chemin du répertoire contenant les images. Il lit ensuite le contenu du répertoire en utilisant la fonction fs.readdir. Ensuite, il filtre les noms de fichiers pour n'inclure que ceux qui portent l'extension ".jpg" ou ".jpeg".

Les chemins de fichiers complets pour les images filtrées sont construits, et la méthode PdfGenerator.imageToPdf est utilisée pour convertir ces images en un document PDF. Le PDF résultant est alors enregistré sous le nom de "composite.pdf" Ce script démontre le processus rationalisé offert par IronPDF pour convertir un lot d'images en un fichier PDF consolidé, offrant une solution pratique pour les scénarios où le contenu des images doit être compilé et présenté dans un seul document.

Comment générer un fichier PDF en Node.js, Figure 3 : PDF de sortie généré à partir d'images en utilisant la bibliothèque IronPDF

PDF de sortie généré à partir d'images en utilisant la bibliothèque IronPDF

5. Conclusion

Node.js, couplé à IronPDF, ouvre un monde de possibilités pour la création dynamique de PDF. Qu'il s'agisse de simples documents textuels ou de rapports complexes au contenu dynamique, IronPDF simplifie le processus et améliore les capacités de vos applications Node.js. Qu'il s'agisse de convertir du HTML en PDF, d'alimenter des modèles ou de compiler des images dans un fichier PDF, IronPDF constitue une solution polyvalente et efficace pour vos besoins en matière de génération de PDF.

En continuant à explorer et à mettre en œuvre ces fonctionnalités, vous découvrirez que la bibliothèque IronPDF Node.js est un outil précieux dans votre trousse à outils de développeur, simplifiant le processus de création de documents PDF dynamiques et visuellement attrayants.

IronPDF for Node.js offre un essai gratuit à leurs utilisateurs. Pour commencer avec IronPDF, visitez cette page de documentation. L'exemple de code et le tutoriel complet de conversion HTML en PDF peuvent être trouvés sur la page du tutoriel suivante.

Darrius Serrant
Ingénieur Logiciel Full Stack (WebOps)

Darrius Serrant est titulaire d'une licence en informatique de l'Université de Miami et travaille en tant qu'ingénieur marketing Full Stack WebOps chez Iron Software. Attiré par le code depuis son plus jeune âge, il a vu l'informatique comme à la fois mystérieuse et accessible, en faisant le support parfait pour la créativité et la résolution de problèmes.

Chez Iron Software, Darrius apprécie de créer de nouvelles choses et de simplifier des concepts complexes pour les rendre plus compréhensibles. En tant que l'un de nos développeurs résidents, il a également fait du bénévolat pour enseigner aux étudiants, partageant son expertise avec la prochaine génération.

Pour Darrius, son travail est épanouissant car il est apprécié et a un réel impact.

< PRÉCÉDENT
Convertir HTML en PDF dans Node.js sans Puppeteer
SUIVANT >
Comment signer un fichier PDF en Node.js