近年来，前端工程师的工作难度越来越大，各种工具和技术层出不穷。其中一个必不可少的工具就是 wkhtmltopdf 或 wkhtmltoimage 这样的工具，它们可以将 HTML 代码转换成 PDF 文件或图片。而 wkhtmltox-promise 就是一个让使用者更加容易使用这两个工具的 npm 包。

wkhtmltox-promise 的功能

将 HTML 代码转换成 PDF 文件或图片；
支持自定义参数，如要求页面缩放、设置内容的宽度和高度等；
支持传递多页文档和 CSS 样式文件等。

安装 wkhtmltox-promise

您可以将 wkhtmltox-promise 作为依赖项添加到您的项目中，也可以全局安装它。

# 作为依赖项添加到您的项目中
npm install wkhtmltox-promise --save

# 全局安装
npm install -g wkhtmltox-promise

使用 wkhtmltox-promise

使用 wkhtmltox-promise，您可以很容易地将一个 HTML 页面转换成 PDF 文件或图片。首先，您需要引入 wkhtmltox-promise 并创建一个新的实例。wkhtmltox-promise 提供了两种方法，一种是通过源代码创建新的实例，另一种是直接传递 HTML 代码或 URL。

// 引入 wkhtmltox-promise
const wkhtmltox = require('wkhtmltox-promise');

// 创建新实例并传递 HTML 代码或 URL
const pdf = await wkhtmltox().source('<h1>Hello World!</h1>').pdf();
const img = await wkhtmltox().source('<h1>Hello World!</h1>').image();

上面的代码将分别创建一个 PDF 文件和一个图片文件。wkhtmltox-promise 支持在源代码中传递多重参数来设置每个文件的大小、分辨率、页面布局等，示例如下：

const pdf = await wkhtmltox()
            .source('<h1>Hello World!</h1>')
            .pdf({ zoom: 2, pageSize: 'letter' });

const img = await wkhtmltox()
            .source('<h1>Hello World!</h1>')
            .image({ width: 800, height: 600 });

wkhtmltox-promise 还支持在源代码中传递多个参数，以便我们可以控制转换过程中的多个参数。示例代码如下：

-- -------------------- ---- -------
-- --------
----- ------- - -
    ----------------------------
    ------------------
    ---------------------
    ------------- ------
    ---------------- ------
    --------------- ------
    -------------- -----
--

-- ---------- ----- - ------- --
----- --- - ----- -----------
    ------------------ -------------
    ------ ------- ---

----- --- - ----- -----------
    ------------------ -------------
    -------- ------- ---

结语

wkhtmltox-promise 是一个非常有用的工具，可以使前端开发人员更加容易地将 HTML 代码转换成 PDF 或图片。本教程简单地介绍了 wkhtmltox-promise 的功能和使用方法，相信大家通过本文的指导，能够更好地使用这个工具，提升自己的工作效率。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/6006710e8dd3466f61ffe1ed

npm 包 wkhtmltox-promise 使用教程

wkhtmltox-promise 的功能

安装 wkhtmltox-promise

使用 wkhtmltox-promise

结语

纠错反馈