如何使用 Puppeteer 在 Node.js 中将 HTML 转换为 PDF

为什么选择 Puppeteer？

• 易用性： Puppeteer 提供了简单易用的 API，抽象化了无头浏览器工作的复杂性。
• 功能强大： Puppeteer 为操作网页和与浏览器元素交互提供了广泛的功能。
• 可扩展：使用 Puppeteer，您可以通过并行运行多个浏览器实例来轻松扩展 PDF 生成流程。

导入 Puppeteer 和fs

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

代码开始于导入两个重要的库：fs，一个用于处理文件系统操作的内置Node.js模块。 Puppeteer 可让您自动执行各种基于网络的任务，包括渲染 HTML、截图和生成 PDF 文件。

定义 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;
}

exportWebsiteAsPdf 函数是我们代码片段的核心。 这个异步函数接收一个 html 字符串和 outputPath 作为输入参数，并返回一个PDF文件。该函数执行以下步骤：

1.使用 Puppeteer 启动一个新的无头浏览器实例。 2.创建新的浏览器页面。

3. 将提供的 html 字符串设置为页面内容，等待DOM内容加载。 4.模拟 "屏幕 "媒体类型，应用屏幕使用的 CSS，而不是打印特定的样式。 5.根据加载的 HTML 内容生成 PDF 文件，指定页边距、背景打印和格式（A4）。 6.关闭浏览器实例。 7.返回创建的 PDF 文件。

使用 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);
});

代码的最后一部分说明了如何使用 exportWebsiteAsPdf 函数。 我们将执行以下步骤：

1. 使用 fs 模块的 readFileSync 方法从HTML文件中读取HTML内容。
2. 使用加载的 html 字符串和所需的 outputPath 调用 exportWebsiteAsPdf 函数。
3. 使用 .then 块处理成功的PDF创建，向控制台记录成功消息。
4. 使用 .catch 块处理HTML到PDF转换过程中的任何错误，向控制台记录错误消息。

本代码片段提供了一个综合示例，说明如何使用 Node.js 和 Puppeteer 将 HTML 模板转换为 PDF 文件。 通过实施该解决方案，您可以高效地生成高质量的 PDF，满足各种应用程序和用户的需求。

导入 Puppeteer

const puppeteer = require('puppeteer');

代码首先要导入 Puppeteer 库，它是控制 Chrome 和 Chromium 等无头浏览器的强大工具。 Puppeteer 允许您自动执行各种基于 Web 的任务，包括渲染 HTML 代码、捕获屏幕截图，以及在我们的案例中生成 PDF 文件。

定义 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;
}

exportWebsiteAsPdf 函数是我们代码片段的核心。 这个异步函数接收一个 websiteUrl 和 outputPath 作为输入参数，并返回一个PDF文件。该函数执行以下步骤：

1.使用 Puppeteer 启动一个新的无头浏览器实例。 2.创建新的浏览器页面。

3. 导航到提供的 websiteUrl 并使用设置为 networkidle0 的 waitUntil 选项等待网络空闲。 4.模拟 "屏幕 "媒体类型，确保应用屏幕使用的 CSS，而不是打印特定的样式。 5.将加载的网页转换为具有指定页边、背景打印和格式（A4）的 PDF 文件。 6.关闭浏览器实例。 7.返回生成的 PDF 文件。

使用 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);
});

代码的最后部分演示了如何使用 exportWebsiteAsPdf 函数。 我们执行以下步骤：

1. 使用所需的 websiteUrl 和 outputPath 调用 exportWebsiteAsPdf 函数。
2. 使用 then 块处理成功的PDF创建。 在该代码块中，我们将向控制台记录一条成功信息。
3. 使用 catch 块处理网站到PDF转换过程中出现的任何错误。 如果出现错误，我们会将错误信息记录到控制台。

将此代码片段集成到您的项目中，您就可以使用 Node.js 和 Puppeteer 轻松地将 URL 转换为高质量的 PDF 文件。

IronPDF 的主要功能

使用 IronPDF 将 HTML 转换为 PDF: IronPDF 允许您将 HTML 内容（包括 CSS）转换为 PDF 文件。 该功能可让您从网页或 HTML 模板创建像素完美的 PDF 文档。

URL渲染： IronPDF可以使用URL直接从服务器获取网页并将其转换为PDF文件，使得存档网络内容或从动态网页生成报告变得容易。

文本、图像和PDF合并： IronPDF允许您将文本、图像和现有PDF文件合并为单个PDF文档。 这一功能对于创建具有多个内容来源的复杂文档尤其有用。

PDF操作： IronPDF提供编辑现有PDF文件的工具，例如添加或删除页面、修改元数据，甚至从PDF文档中提取文本和图像。