Cómo generar un archivo PDF en Node.js

Este artículo se esfuerza por profundizar en las intrincadas sutilezas de IronPDF, guiando a los lectores a través de cada faceta desde el proceso de instalación inicial hasta su implementación práctica en escenarios del mundo real.

1. ¿Cómo utilizar el generador de PDF de Node.js?

1. Instale la IronPDF para la biblioteca de generación de PDF de Node.js.

2. Importe las dependencias necesarias.

3. Renderiza HTML como PDF usando la función PdfDocument.fromHtml.

4. Generar PDF desde URL usando el método PdfDocument.fromUrl.

5. Convierte imágenes en archivos PDF utilizando el método imageToPdf.

6. Guarda los archivos PDF creados usando el método saveAs.

2. Exploración de IronPDF for Node.js

IronPDF from Iron Software es una formidable biblioteca de PDF meticulosamente diseñada para Node.js, que dota a los desarrolladores de la capacidad de generar archivos PDF sin esfuerzo. Con una amplia gama de características, IronPDF demuestra su versatilidad, atendiendo a un espectro de casos de uso que abarca desde la generación de documentos y la creación de informes hasta el renderizado de contenido. Entre sus atributos más destacados se encuentra la notable capacidad de convertir sin problemas una plantilla HTML e imágenes en archivos PDF, lo que demuestra la adaptabilidad y eficacia de la biblioteca a la hora de manejar diversas fuentes de contenido.

2.1. Instalación de IronPDF

Antes de sumergirte en el mundo de la generación de PDFs, necesitas instalar IronPDF. El proceso es sencillo gracias a npm, el gestor de paquetes de Node.js. Abra su terminal y ejecute el siguiente comando:

npm i @ironsoftware/ironpdf

Este comando obtiene e instala el paquete IronPDF, haciéndolo disponible para su uso en su proyecto Node.js.

Para instalar el motor IronPDF necesario para utilizar la biblioteca IronPDF, ejecute el siguiente comando en la consola.

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

3. Añadir paquetes necesarios

Una vez instalado IronPDF, deberá incluir los paquetes necesarios en su proyecto utilizando la sentencia import. Esto le garantiza el acceso a las funcionalidades proporcionadas por IronPDF. Considere el siguiente ejemplo:

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

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

Esta declaración de importación introduce la clase PdfDocument, un componente fundamental para generar archivos PDF con IronPDF.

4. Generación de archivos PDF

Ahora que IronPDF está configurado en su proyecto, vamos a explorar el proceso básico de generación de un archivo PDF utilizando el paquete PDF creator. Hay muchas maneras de crear archivos PDF utilizando IronPDF, pero este artículo tratará algunas de ellas.

1. Cadena HTML a PDF

2. URL a PDF

3. Imágenes a PDF

4.1. Convertir HTML a PDF con IronPDF

Una de las características más destacadas de IronPDF es su capacidad para convertir HTML en archivos PDF sin esfuerzo. Esto resulta especialmente útil cuando se generan contenidos dinámicos en el servidor y se desea presentarlos en formato PDF. He aquí un ejemplo sencillo:

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

Este fragmento de código utiliza IronPDF, una biblioteca de Node.js, para generar dinámicamente un documento PDF a partir de una cadena HTML especificada. Comienza importando la clase PdfDocument del paquete IronPDF. La siguiente función asincrónica emplea el método fromHtml para crear un documento PDF, utilizando un elemento de encabezado simple en este caso. El método saveAs se utiliza a continuación para exportar el PDF generado a un archivo llamado "output.pdf".

La naturaleza asincrónica del código se gestiona mediante el uso de la sintaxis async/await, asegurando que los procesos de generación y guardado de datos PDF ocurran de manera no bloqueante. En general, este ejemplo sucinto demuestra cómo IronPDF agiliza la creación y manipulación de PDF en un entorno Node.js.

Salida

PDF de salida generado a partir de una cadena HTML utilizando la biblioteca IronPDF

4.2. Crear archivos PDF desde una URL con IronPDF

La creación de archivos PDF a partir de una URL mediante IronPDF en Node.js es una potente función que permite convertir contenido web en documentos PDF mediante programación. He aquí un fragmento de código de ejemplo que muestra cómo conseguirlo:

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

En este código:

1. La clase PdfDocument se importa del paquete IronPDF.

2. Dentro de una función asincrónica (envuelta en una expresión de función inmediatamente invocada), se define una variable url con la URL de la página web que deseas convertir a un PDF.

3. El método fromUrl se utiliza para crear un documento PDF desde la URL especificada. IronPDF obtiene el contenido de la URL y lo convierte en un documento PDF.

4. Finalmente, se utiliza el método saveAs para guardar el PDF generado en un archivo llamado "output_from_url.pdf".

   Este ejemplo muestra la sencillez de uso de IronPDF para convertir el contenido web de una URL en un archivo PDF, lo que lo convierte en una valiosa herramienta para situaciones en las que el contenido web dinámico debe archivarse o compartirse en formato PDF.

   

   PDF de salida generado desde una URL usando la biblioteca IronPDF

4.3. Generación de archivos PDF a partir de imágenes con IronPDF

Además de HTML, IronPDF ofrece funciones para generar archivos PDF a partir de imágenes. Esto resulta especialmente útil cuando hay que compilar imágenes en un único documento PDF. Veamos un ejemplo sencillo:

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
  });
})();

Este código utiliza IronPDF, una biblioteca Node.js, para convertir una colección de imágenes JPEG en un directorio específico en un único documento PDF. Inicialmente, el código especifica la ruta del directorio que contiene las imágenes. A continuación, lee el contenido del directorio usando la función fs.readdir. A continuación, filtra los nombres de archivo para incluir sólo aquellos con extensiones ".jpg" o ".jpeg".

Las rutas completas de los archivos para las imágenes filtradas se construyen, y se utiliza el método PdfGenerator.imageToPdf para convertir estas imágenes en un documento PDF. El PDF resultante se guarda como "composite.pdf". Este script demuestra el proceso racionalizado que ofrece IronPDF para convertir un lote de imágenes en un archivo PDF consolidado, proporcionando una solución práctica para escenarios en los que el contenido de las imágenes necesita ser compilado y presentado en un único documento.

PDF de salida generado a partir de imágenes usando la biblioteca IronPDF

5. Conclusión

Node.js, junto con IronPDF, abre un mundo de posibilidades para la creación dinámica de PDF. Desde simples documentos basados en texto hasta complejos informes con contenido dinámico, IronPDF simplifica el proceso y mejora las capacidades de sus aplicaciones Node.js. Ya se trate de convertir HTML a PDF, rellenar plantillas o compilar imágenes en un archivo PDF, IronPDF ofrece una solución versátil y eficaz para sus necesidades de generación de PDF.

A medida que continúas explorando e implementando estas funciones, descubrirás que la biblioteca IronPDF Node.js es una herramienta valiosa en tu conjunto de herramientas de desarrollador, simplificando el proceso de creación de documentos PDF dinámicos y visualmente atractivos.

IronPDF for Node.js ofrece una prueba gratuita para sus usuarios. Para comenzar con IronPDF, visite esta página de documentación. El ejemplo de código y el tutorial completo de conversión de HTML a PDF se pueden encontrar en la siguiente página del tutorial.