集成

开发者 SDK

一座桥连接浏览器与打印机 — 无头标签打印 SDK,适配任意 Web 应用

TopBridge SDK 是一个无头(headless)、浏览器原生的标签打印库，将标签打印直接嵌入您的 Web 应用。JS Core 现已在 npm 上线，React 和 Next.js 包装器即将推出。

从一开始就为生产环境设计：零外部依赖、一行调用的 preflight 编排（健康检查 → 配额校验 → 打印机发现）、10 种结构化错误类型支持 instanceof 类型收窄、TopBridge 托盘应用的自动启动 + 重试机制，以及涵盖固定连接端点、来源验证、输入净化和构建时混淆的安全模型。

npm 包：@appzgatenz/label-print-topbridge-js——直接使用 npm install @appzgatenz/label-print-topbridge-js 安装。

关于 SDK 的文档和帮助：阅读 SDK 入门指南查看安装方法、API 参考与代码示例。

如果您不想在本地进行安装，可以直接访问我们的在线 Playground 进行直接体验 —— 无需任何配置。

GitHub 源码：Playground demo 是开源的——查看完整集成代码：github.com/youngming/label-print-topbridge-js-SDK-demo。

example.ts

import { TopBridgeClient } from '@appzgatenz/label-print-topbridge-js';

const client = new TopBridgeClient();

// Preflight: health check → quota → printer discovery
const { printers } = await client.preflight.run();

// Print a label
await client.print.execute({
  template: 'PRICE_LABEL',
  printer:  'TSC DA220',
  products: [
    { name: 'Apple', price: 3.99, copies: 2 },
  ],
});