Cómo Convertir HTML a PDF en Node.js usando Puppeteer

¿Por qué Puppeteer?

• Facilidad de uso: Puppeteer ofrece una API simple e intuitiva que abstrae las complejidades de trabajar con navegadores sin cabeza.
• Potente: Puppeteer proporciona amplias capacidades para manipular páginas web e interactuar con elementos del navegador.
• Escalable: Con Puppeteer, es posible escalar fácilmente el proceso de generación de PDF ejecutando varias instancias del navegador en paralelo.

Importación de Puppeteer y fs

const puppeteer = require('puppeteer');
const fs = require('fs');

El código comienza importando dos bibliotecas esenciales: puppeteer, una herramienta versátil para controlar navegadores sin cabeza como Chrome y Chromium, y fs, un módulo Node.js integrado para manejar operaciones del sistema de archivos. Puppeteer te permite automatizar una amplia gama de tareas basadas en la web, incluyendo renderizar HTML, capturar capturas de pantalla y generar archivos PDF.

Definición de la función exportWebsiteAsPdf

async function exportWebsiteAsPdf(html, outputPath) {
  // Create a browser instance
  const browser = await puppeteer.launch({
    headless: true // Launches the browser in headless mode
  });

  // Create a new page
  const page = await browser.newPage();

  // Set the HTML content for the page, waiting for DOM content to load
  await page.setContent(html, { waitUntil: 'domcontentloaded' });

  // To reflect CSS used for screens instead of print
  await page.emulateMediaType('screen');

  // Download the PDF
  const PDF = await page.pdf({
    path: outputPath,
    margin: { top: '100px', right: '50px', bottom: '100px', left: '50px' },
    printBackground: true,
    format: 'A4',
  });

  // Close the browser instance
  await browser.close();

  return PDF;
}

La función exportWebsiteAsPdf sirve como núcleo de nuestro fragmento de código. Esta función asíncrona acepta una cadena html y un outputPath como parámetros de entrada y devuelve un archivo PDF. La función realiza los siguientes pasos:

1. Lanza una nueva instancia de navegador sin cabeza usando Puppeteer.
2. Crea una nueva página de navegador.
3. Establece la cadena html proporcionada como el contenido de la página, esperando que se cargue el contenido del DOM.
4. Emula el tipo de medio 'pantalla' para aplicar el CSS utilizado para pantallas en lugar de estilos específicos para impresión.
5. Genera un archivo PDF del contenido HTML cargado, especificando márgenes, impresión de fondo y formato (A4).
6. Cierra la instancia del navegador.
7. Devuelve el archivo PDF creado.

Uso de la función exportWebsiteAsPdf

// Usage example
// Get HTML content from HTML file
const html = fs.readFileSync('test.html', 'utf-8');

// Convert the HTML content into a PDF and save it to the specified path
exportWebsiteAsPdf(html, 'result.pdf').then(() => {
  console.log('PDF created successfully.');
}).catch((error) => {
  console.error('Error creating PDF:', error);
});

La última sección del código ilustra cómo utilizar la función exportWebsiteAsPdf. Realizamos los siguientes pasos:

1. Lea el contenido HTML de un archivo HTML utilizando el método fs del módulo readFileSync.
2. Llame a la función exportWebsiteAsPdf con la cadena html cargada y el outputPath deseado.
3. Utilice un bloque .then para manejar la creación exitosa del PDF y registrar un mensaje de éxito en la consola.
4. Utilice un bloque .catch para administrar cualquier error que ocurra durante el proceso de conversión de HTML a PDF, registrando un mensaje de error en la consola.

Este fragmento de código proporciona un ejemplo completo de cómo convertir una plantilla HTML a un archivo PDF usando Node.js y Puppeteer. Al implementar esta solución, puedes generar de manera eficiente PDFs de alta calidad, satisfaciendo las necesidades de varias aplicaciones y usuarios.

Importar Puppeteer

const puppeteer = require('puppeteer');

El código comienza importando la biblioteca Puppeteer, que es una herramienta poderosa para controlar navegadores sin cabeza como Chrome y Chromium. Puppeteer te permite automatizar una variedad de tareas basadas en la web, incluido el renderizado de tu código HTML, la captura de capturas de pantalla y, en nuestro caso, la generación de archivos PDF.

Definición de la función exportWebsiteAsPdf

async function exportWebsiteAsPdf(websiteUrl, outputPath) {
  // Create a browser instance
  const browser = await puppeteer.launch({
    headless: true // Launches the browser in headless mode
  });

  // Create a new page
  const page = await browser.newPage();

  // Open the URL in the current page
  await page.goto(websiteUrl, { waitUntil: 'networkidle0' });

  // To reflect CSS used for screens instead of print
  await page.emulateMediaType('screen');

  // Download the PDF
  const PDF = await page.pdf({
    path: outputPath,
    margin: { top: '100px', right: '50px', bottom: '100px', left: '50px' },
    printBackground: true,
    format: 'A4',
  });

  // Close the browser instance
  await browser.close();

  return PDF;
}

La función exportWebsiteAsPdf es el núcleo de nuestro fragmento de código. Esta función asíncrona acepta websiteUrl y outputPath como parámetros de entrada y devuelve un archivo PDF. La función realiza los siguientes pasos:

1. Lanza una nueva instancia de navegador sin cabeza usando Puppeteer.
2. Crea una nueva página de navegador.
3. Navega hasta el websiteUrl proporcionado y espera a que la red quede inactiva usando la opción waitUntil establecida en networkidle0.
4. Emula el tipo de medio 'pantalla' para asegurar que se aplique el CSS utilizado para pantallas en lugar de estilos específicos para impresión.
5. Convierte la página web cargada en un archivo PDF con los márgenes especificados, impresión de fondo y formato (A4).
6. Cierra la instancia del navegador.
7. Devuelve el archivo PDF generado.

Uso de la función exportWebsiteAsPdf

// Usage example
// Convert the URL content into a PDF and save it to the specified path
exportWebsiteAsPdf('https://ironpdf.com/', 'result.pdf').then(() => {
  console.log('PDF created successfully.');
}).catch((error) => {
  console.error('Error creating PDF:', error);
});

La sección final del código demuestra cómo utilizar la función exportWebsiteAsPdf. Ejecutamos los siguientes pasos:

1. Llame a la función exportWebsiteAsPdf con los websiteUrl y outputPath deseados.
2. Utilice un bloque then para manejar la creación exitosa del PDF. En este bloque, registramos un mensaje de éxito en la consola.
3. Utilice un bloque catch para manejar cualquier error que ocurra durante el proceso de conversión del sitio web a PDF. Si ocurre un error, registramos un mensaje de error en la consola.

Al integrar este fragmento de código en tus proyectos, puedes convertir fácilmente URLs en archivos PDF de alta calidad usando Node.js y Puppeteer.

Características principales de IronPDF

Conversión HTML a PDF con IronPDF: IronPDF permite convertir contenido HTML, incluyendo CSS, a archivos PDF. Esta característica posibilita crear documentos PDF de alta calidad a partir de páginas web o plantillas HTML.

Representación de URL: IronPDF puede obtener páginas web directamente desde un servidor mediante una URL y convertirlas en archivos PDF, lo que facilita el archivado de contenido web o la generación de informes a partir de páginas web dinámicas.

Fusión de texto, imágenes y PDF: IronPDF le permite fusionar texto, imágenes y archivos PDF existentes en un solo documento PDF. Esta característica es particularmente útil para crear documentos complejos con múltiples fuentes de contenido.

Manipulación de PDF: IronPDF proporciona herramientas para editar archivos PDF existentes, como agregar o eliminar páginas, modificar metadatos o incluso extraer texto e imágenes de documentos PDF.