Js on Tarragonhttps://tarrragon.github.io/blog/tags/js/Recent content in Js on TarragonHugo -- gohugo.iozh-TWTarragon (CC BY 4.0)Fri, 19 Jun 2026 00:00:00 +0000模組三：SDK 設計模式https://tarrragon.github.io/blog/monitoring/03-sdk-design/Fri, 19 Jun 2026 00:00:00 +0000https://tarrragon.github.io/blog/monitoring/03-sdk-design/<p>回答「怎麼在各平台埋點」。三個 SDK（JS/Flutter/Python）共用同一套事件格式，公開 API 保持一致。</p> <h2 id="待寫章節">待寫章節</h2> <ul> <li><input checked="" disabled="" type="checkbox"> SDK 公開 API 設計（init / event / error / metric / flush / close）</li> <li><input checked="" disabled="" type="checkbox"> 自動攔截機制（JS window.onerror / Flutter FlutterError / Python sys.excepthook）</li> <li><input checked="" disabled="" type="checkbox"> 攢批送出策略（flush interval / buffer size / flush on close）</li> <li><input checked="" disabled="" type="checkbox"> 離線 buffer 與重試（FIFO 丟棄 / 本地 persistence / 恢復後補發的取捨）</li> <li><input checked="" disabled="" type="checkbox"> SDK redaction helper（模組七的實作層）</li> </ul> <h2 id="跨分類引用">跨分類引用</h2> <ul> <li>→ <a href="https://tarrragon.github.io/blog/testing/03-protocol-integration-test/" data-link-title="模組三：協議整合測試" data-link-desc="對真實服務驗證 WebSocket / gRPC / HTTP 協議契約 — unit test 和 E2E test 之間的一層">testing 模組三 協議整合測試</a>：SDK 的 HTTP POST 行為需要 protocol test</li> <li>→ <a href="https://tarrragon.github.io/blog/monitoring/07-security-privacy/" data-link-title="模組七：資安與隱私" data-link-desc="SDK redaction / transport 加密 / collector access control / 去識別化 — 蒐集的資料本身就是風險資產">monitoring 模組七 資安</a>：redaction 在 SDK 端做</li> <li>← <a href="https://tarrragon.github.io/blog/testing/01-test-strategy-layers/" data-link-title="模組一：測試策略分層" data-link-desc="Unit / Protocol Integration / Screen State 三層測試各自的職責、盲區和判斷原則">testing 模組一 測試策略</a>：mock 遮蔽機制影響 SDK 的 auto-intercept 行為驗證</li> <li>實作 repo：tarrragon/monitor 的 sdk-js / sdk-flutter / sdk-python</li> </ul>回答「怎麼在各平台埋點」。三個 SDK（JS/Flutter/Python）共用同一套事件格式，公開 API 保持一致。

待寫章節

  • SDK 公開 API 設計（init / event / error / metric / flush / close）
  • 自動攔截機制（JS window.onerror / Flutter FlutterError / Python sys.excepthook）
  • 攢批送出策略（flush interval / buffer size / flush on close）
  • 離線 buffer 與重試（FIFO 丟棄 / 本地 persistence / 恢復後補發的取捨）
  • SDK redaction helper（模組七的實作層）

跨分類引用

]]>