Puppeteer / Playwright 与 web-print-pdf 打印方案对比

团队常用 Puppeteer、Playwright 在无头 Chrome 中 page.pdf() 生成 PDF,适合服务端归档、CI、批量出文件;若要在用户 PC 指定打印机、静默出纸、WMS 工位无人值守,需对比 web-print-pdf 本地客户端。两者职责不同,也可组合使用。另见 jsPDF 对比。

如何阅读本文

Puppeteer 与 web-print-pdf 解决不同层级的问题:前者偏服务端 PDF/自动化,后者偏工位 PC 物理出纸。不必二选一——常见组合是 Puppeteer 存证 + web-print-pdf 打票。

两种方案分别是什么

Puppeteer / Playwright

Node 侧驱动 Chromium,适合服务端渲染 PDF、截图、自动化测试。把 PDF 送到办公室/仓库物理打印机通常还要传文件、驱动打印队列或每台机器跑脚本——运维复杂。

Web打印专家 + web-print-pdf

浏览器内 npm install web-print-pdf + 用户安装Web打印专家客户端;printHtml 在本机渲染并静默打印,支持打印机名、份数、热敏宽度、batchPrint 与远程推送。

web-print-pdf 的适用优势

  • 终端直打:PDF 不必落地再人工打印
  • 前端集成:ERP/WMS 页面按钮即可触发
  • 打印机管理:枚举本机打印机、默认纸型
  • 远程推送:服务端推任务,工位 PC 自动出纸
Puppeteer 适合数据中心生成 PDF/归档;web-print-pdf 适合业务 PC 静默打实体票。也可组合:Puppeteer 归档 + 工位 web-print-pdf 出纸。

功能对比(客观参考)

下表供选型参考,具体以各产品当前版本为准。

维度Puppeteer / Playwrightweb-print-pdf
运行位置服务器 Node用户 PC 浏览器 + 客户端
物理打印机需额外传 PDF/脚本原生支持
静默打印服务端 PDF 易;终端直打难终端静默
前端改动多为后端任务npm 前端 API
远程工位需自建传 PDF 链路WebSocket/HTTP 推送;见 WMS 专题
运维Chromium 依赖、容器资源安装客户端即可
更适合批量 PDF、CI、归档ERP/WMS 工位出纸

选型决策参考(按需求维度)

先明确任务发生在「服务器出 PDF」还是「工位 PC 出纸」。

若您的首要诉求是…可优先了解说明
服务端批量 PDF、邮件附件Puppeteer / Playwrightpage.pdf()、CI 归档
仓库/前台静默打票web-print-pdf见 热敏面单
浏览器内导出 PDFjsPDF见 jsPDF 对比
服务端推任务、工位无人值守web-print-pdf 远程打印见 WMS 专题
用户手动点打印、可弹窗Print.js见 Print.js 对比

按场景怎么选

继续 Puppeteer

只要服务端 PDF 文件

报表归档、邮件附件、对象存储——Puppeteer page.pdf() 足够。

推荐 web-print-pdf

仓库/前台要静默打票

快递面单、收银小票——本地客户端 + printHtml;见 热敏面单专题。

组合

服务端归档 + 工位出纸

Puppeteer 生成 PDF 存证,同时 push HTML 任务到工位 web-print-pdf。

与本站其他专题如何配合阅读

常见问题

Puppeteer 能直接打本地打印机吗?

通常要在服务器或每台 PC 上额外编排 PDF 打印,不如专用客户端方案直接。

web-print-pdf 能在 Node 里跑吗?

npm 在浏览器侧调用;通过 WebSocket 与本地客户端通信,不是无头 Chrome 脚本。

Playwright 是否一样?

Playwright 与 Puppeteer 同属无头浏览器自动化,对比结论类似。

和 jsPDF 呢?

jsPDF 在浏览器生成 PDF 文件;见 jsPDF 对比。

Docker 里跑 Puppeteer 能替代客户端吗?

容器内 Puppeteer 仍产出 PDF 文件,无法直接驱动各工位热敏机。工位出纸需 web-print-pdf 客户端或等价本地打印链路。

说明

本页为选型参考,第三方产品名称仅用于识别与对比,商标归各自权利人所有。

各平台客户端部署

同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。

免费下载客户端 查看 npm 包 开发文档