web-print-pdf：基于 Playwright 的 Web 打印解决方案

支持 A4、A5、80mm 热敏纸、自定义尺寸等，完全满足电商面单、医疗标签、财务凭证等不同场景。

✅ 高质量的 PDF 生成与预览

不是截图式的 PDF，而是真正可复制、可搜索的矢量 PDF。并且支持生成预览链接：

const previewUrl = await previewHtml({
  content: reportHTML,
  options: {
    header: '月度销售报告',
    footer: '第 {page} 页 / 共 {totalPages} 页',
    watermark: {
      text: '预览版',
      opacity: 0.2
    }
  }
});
// 在新窗口打开预览
window.open(previewUrl);

用户可以先确认预览效果，再点击打印，而且这个预览是真实的 PDF 文档，不是浏览器自带的打印弹窗。

✅ 批量打印 + 队列管理

双十一大促期间，订单如潮水般涌来，系统不能崩溃，打印机也不能过载。web-print-pdf 内置了轻量级的打印队列：

import { createPrintQueue } from 'web-print-pdf';
const queue = createPrintQueue({
  concurrency: 2, // 同时最多 2 个打印任务
  delay: 300, // 每个任务间隔 300ms
  onProgress: (done, total) => {
    console.log(`已打印：${done}/${total}`);
  }
});
orders.forEach(order => {
  queue.add(() => printHtml({
    content: generateOrderHtml(order),
    silent: true,
    printer: 'Shipping_Printer'
  }));
});
await queue.start();

稳定、可控，再也不怕大批量打印把系统拖垮。

✅ 远程打印（最新功能）

总部在北京，门店在上海，如何让上海的前台通过 Web 系统直接打印上海店里的收据？

web-print-pdf 新增的远程打印模块，让这件事变得简单：

await remotePrint({
  document: {
    type: 'html',
    content: ticketHTML
  },
  printer: {
    id: 'shanghai-store-01', // 远程打印机 ID
    location: 'branch'
  },
  remoteConfig: {
    endpoint: 'https://print-gateway.example.com',
    authToken: 'your-secure-token'
  }
});

打印任务经过加密传输，安全送达指定门店的打印机，分布式办公从未如此简单。

技术优势：为什么它比自研方案更可靠？

很多大公司遇到打印需求时的第一反应是'自己封装一个 Electron 应用'，但这条路往往踩坑无数：

· 内存泄漏 —— 窗口开多了不回收 · 跨平台差异 —— Windows 能打，Mac 报错 · 并发控制 —— 打印机任务堆积，系统卡死

而 web-print-pdf 直接选用 Playwright 作为内核，这是微软出品的自动化测试工具，稳定性、并发能力、跨浏览器兼容性都经过全球开发者验证。项目团队在 Playwright 的基础上做了大量减法：只保留打印、PDF 生成、预览等核心功能，移除不必要的依赖，优化内存回收策略。

实测数据（来自某电商客户的生产环境）：

· 单任务内存占用：80-120MB（原生 Playwright 约 150-200MB） · 简单页面打印耗时：400-800ms（原生约 800-1200ms） · 10 个任务并发：5.2 秒完成（原生约 8.5 秒）

用更少的资源，做更多的事。

适用场景：哪些项目应该考虑它？

如果你的项目遇到以下任意一条，都值得试试：

· ☑️ 需要不弹窗、无预览的直接打印 · ☑️ 需要指定打印机（如发票机、标签机） · ☑️ 需要批量处理大量打印任务 · ☑️ 需要远程打印到其他办公地点 · ☑️ 需要高质量 PDF 预览再决定是否打印

快速上手：3 分钟接入

第 1 步：安装

npm install web-print-pdf

第 2 步：部署本地打印服务

web-print-pdf 需要配合一个轻量级的本地服务（基于 Electron）使用。这个服务只需部署一次，所有 Web 应用均可复用。

第 3 步：调用 API

import { printPdfByUrl } from 'web-print-pdf';
// 打印远程 PDF 文件
await printPdfByUrl({
  url: 'https://example.com/invoice.pdf',
  silent: true,
  printer: 'HP-LaserJet-MFP'
});

就是这么简单。你不需要关心底层是如何调用 CUPS 还是 Win32 API，一个函数解决战斗。

写在最后

在 Web 技术几乎能搞定一切今天，'打印'依然是那个最顽固的难题。不是技术做不到，而是浏览器为了安全筑起了高墙。而 web-print-pdf 选择了一条务实的路径：不挑战浏览器的安全边界，而是在边界之外建立一个'打印代理'。

它没有试图发明新的打印标准，只是把 Playwright、PDF 生成、队列管理等成熟技术组合起来，并封装成符合前端开发者习惯的 Promise API。

如果你正在为项目的打印功能焦头烂额，不妨花半小时试试它。也许这就是你一直在找的那个'把问题彻底解决掉'的工具。