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

导入 Puppeteer 和fs

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

代码首先导入两个重要的库：puppeteer，一个用于控制 Chrome 和 Chromium 等无头浏览器的多功能工具；以及 fs，一个用于处理文件系统操作的内置 NodeJS 模块。 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 转换过程中发生的任何错误，并将错误消息记录到控制台。

本代码片段提供了一个综合示例，说明如何使用 NodeJS 和 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，并使用设置为 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 过程中发生的任何错误。 如果出现错误，我们会将错误信息记录到控制台。

将此代码片段集成到您的项目中，您就可以使用 NodeJS 和 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 文档中提取文本和图像。