必须先连接客户端吗?
是。未连接会抛错;可用 getConnectStatus 预检,见 error-handling。
printHtml(html, pdfOptions, printOptions, extraOptions) 是 web-print-pdf 的主入口:将 HTML 字符串经本地客户端渲染为 PDF 并投递打印机。本文汇总四参分工、典型集成模式、踩坑与立项评估,面向前端负责人与架构师。
printHtml(
html: string,
pdfOptions?: PdfOptions,
printOptions?: PrintOptions,
extraOptions?: ExtraOptions
): Promise<PrintResult>import webPrintPdf from 'web-print-pdf';
const ok = await webPrintPdf.getConnectStatus();
if (!ok) throw new Error('请先启动打印客户端');
await webPrintPdf.printHtml(
reportHtml,
{ paperFormat: 'A4', printBackground: true, margin: { top: '10mm', bottom: '10mm' } },
{ printerName: '财务室激光', copies: 1, duplex: 'longEdge' }
);| 模式 | 用法 |
|---|---|
| DOM 提取 | Vue/React ref 取 innerHTML → printHtml |
| 后端 HTML 字符串 | API 返回完整 HTML 文档 |
| 仅预览 | extraOptions.action: "preview" |
| 鉴权 URL | 改用 printHtmlByUrl + extraOptions |
getConnectStatus是。未连接会抛错;可用 getConnectStatus 预检,见 error-handling。
成对填写且语义一致,尤其 paperFormat/width/height。
extraOptions.action = "preview"。
仅浏览器事件/client 组件;Node SSR 中不要 import 后直接调。
ByUrl 由客户端抓 URL;printHtml 直接传 HTML 字符串。
同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。