与循环 printHtml 比?
batchPrint 由客户端排队,减少浏览器往返;高峰更稳。
batchPrint(list, pdfOptions, printOptions, extraOptions) 用于连续多任务打印:面单波次、财务月结、药房发药高峰等。后三个参数为批量默认值;每条任务可自带 options,任务级覆盖批量级。本文面向技术负责人说明合并规则、性能对比、典型模式与立项评估。
batchPrint(
list: BatchTask[],
pdfOptions?: PdfOptions,
printOptions?: PrintOptions,
extraOptions?: ExtraOptions
): Promise<BatchResult>| 规则 | 说明 |
|---|---|
| 默认参数 | 第 2~4 参作用于所有任务 |
| 任务覆盖 | 单条 task.pdfOptions / printOptions 优先 |
| 失败 | 见 error-handling;可逐条 catch |
import webPrintPdf from 'web-print-pdf';
const labels = orders.map((o) => ({
html: renderLabelHtml(o),
// 任务级覆盖:大件走货运打印机
printOptions: o.heavy ? { printerName: '货运激光' } : undefined
}));
await webPrintPdf.batchPrint(
labels,
{ width: '100mm', height: '150mm', printBackground: true },
{ printerName: '热敏面单机', copies: 1 }
);| 模式 | 场景 | 要点 |
|---|---|---|
| 统一默认 + 少量覆盖 | 同规格面单波次 | 批量 pdfOptions 设纸宽;异常单在 task 上覆盖 printerName |
| 全量任务自带 options | 月结多种报表 | 批量默认可省略;每 task 完整 pdf/print |
| 远程推送数组 | WMS 服务端 | JSON 数组直接映射 list;客户端排队执行 |
| 循环改 batch | 高峰性能 | 减少浏览器↔客户端往返,见下文对比 |
for + printHtml 改为客户端侧队列(降低延迟与失败率)formatPrintErrorgetConnectStatus,再按任务重试batchPrint 由客户端排队,减少浏览器往返;高峰更稳。
可以—在 task.printOptions.printerName 覆盖。
查返回结果与 formatPrintError;见 error-handling。
可选;任务内 options 完整时可省略批量默认。
远程推送为固定格式 JSON 入队(type 可为 batchPrint),由客户端经消费接口接收后执行;不是浏览器调 batchPrint。字段格式可对照 batchPrint API。
同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。