整合

開發者 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 },
  ],
});