在前端开发中，我们经常需要将页面内容转换成 PDF 文件，而这时候我们可以使用 gen-pdf 这个 npm 包来简化这个过程。本教程将会介绍如何使用 gen-pdf 这个 npm 包，并带来一些例子来让你更好的理解。
什么是 gen-pdf？
gen-pdf 是一个针对 Node.js 和浏览器的 PDF 渲染引擎，其底层使用 Puppeteer 来对页面进行渲染并生成 PDF 文件。这意味着在使用 gen-pdf 之前需要确保 Puppeteer 能成功地运行。
安装
通过以下命令，可以将 gen-pdf 安装到你的应用程序中：
npm install gen-pdf --save
如何使用 gen-pdf？
gen-pdf 提供了一个非常简单和容易理解的 API。我们来看看下面的例子：
-- -------------------- ---- ------- ----- ------ - ------------------- ----- ------- - - ---- --------------------- ----------- - ------- -------- - -- ------------------------ -- - ---------------- -------- --------------------------------- -------------- -- - ----------------------- ------- ---
在这段代码中，我们传入一个包含以下几个可能的参数的配置对象：
url：要渲染的页面 URL。html：要渲染的 HTML 内容，需要在代码中包含。pdfOptions：一些指定 PDF 文件格式的选项。puppeteerOptions：将传递给底层 Puppeteer 的选项。
我们将只需要 url 和 pdfOptions 两个选项进行 PDF 生成。然后我们使用 write 方法将生成的 PDF 内容保存到 /path/to/output.pdf 这个路径下。
如果你需要从 HTML 中生成 PDF，只需要将 url 替换为 html 即可。同时，你可以根据你的需要调整 PDF 格式选项。
深入学习 gen-pdf
使用 gen-pdf 进行 PDF 生成只是一个简单的应用，更多的选项和技能值得深入学习。以下是一个利用 gen-pdf 生成具有自定义样式表的 PDF 文件的例子：
-- -------------------- ---- -------
----- ------ - -------------------
----- -- - --------------
----- ---- - ----------------
----- ------- - -------------------- ----------------
----- ---- - -
------
------
----- --------------- ---------------- -------------------
-------
------
--------- -----------
---------------------
-------
-------
--
----- ------- - -
-----
----------- - ------- ---- -
--
------------------------ -- -
----- ------ - --------------------------------------------
-----------------
-------------- -- -
---------------------
---在这个例子中，我们使用 fs 和 path 模块读取使用 link 标签引用的样式表文件，然后将其传递到渲染的 HTML 中。 需要注意的是，我们在 pdfOptions 中选择了一个不同的文件格式（A4）。最后我们将 PDF 文件写入 /path/to/output.pdf 路径中。
这个例子只是 gen-pdf 的简单例子，大部分更复杂的功能可以通过查阅它的文档来学习。
结语
在本教程中，我们学习了如何使用 gen-pdf 创建 PDF 文件。正如我们所看到的，这个 npm 包并不难使用，不过还提供了很多深入学习的选项和技能。现在你可以试着使用 gen-pdf 进行 PDF 文件生成并开发你自己的应用了。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600566fe81e8991b448e3419