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

¿Por qué Puppeteer?

• Facilidad de uso: Puppeteer ofrece una API simple y fácil de usar que abstrae las complejidades de trabajar con navegadores sin cabeza.
• Poderoso: Puppeteer proporciona amplias capacidades para manipular páginas web e interactuar con elementos del navegador.
• Escalable: Con Puppeteer, puedes escalar fácilmente tu 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 incorporado de NodeJS para manejar operaciones de 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 el núcleo de nuestro fragmento de código. Esta función asincrónica acepta una cadena html y una 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 a que cargue el contenido 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 usar la función exportWebsiteAsPdf. Realizamos los siguientes pasos:

1. Lee el contenido HTML desde un archivo HTML usando el método readFileSync del módulo fs.
2. Llama a la función exportWebsiteAsPdf con la cadena html cargada y la outputPath deseada.
3. Utiliza un bloque .then para manejar la creación exitosa del PDF, registrando un mensaje de éxito en la consola.
4. Emplea un bloque .catch para manejar 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 NodeJS 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 asincrónica acepta un websiteUrl y un outputPath como sus 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 a la websiteUrl proporcionada y espera a que la red se vuelva 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 usar la función exportWebsiteAsPdf. Ejecutamos los siguientes pasos:

1. Llama a la función exportWebsiteAsPdf con la websiteUrl y outputPath deseadas.
2. Usa un bloque then para manejar la creación exitosa del PDF. En este bloque, registramos un mensaje de éxito en la consola.
3. Usa un bloque catch para manejar cualquier error que ocurra durante el proceso de conversión de la página 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 NodeJS y Puppeteer.

Características principales de IronPDF

Conversión HTML a PDF con IronPDF: IronPDF te permite convertir contenido HTML, incluyendo CSS, a archivos PDF. Esta característica te permite 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.