rivetkit-client-javascript

RivetKit JavaScript 客戶端技能為開發者提供將 Rivet Actors 整合至瀏覽器、Node.js 或 Bun 環境的完整指南。它支援與高效能記憶體內行程進行無縫通訊，促進即時狀態管理、遠端程序呼叫 (RPC) 以及雙向事件串流。對於建構反應式前端介面、伺服器端後端服務或需要地理分散式 Actor 架構的跨平台應用程式的工程師而言，此技能至關重要。

• 使用 createClient 進行客戶端初始化，支援自定義端點與環境變數配置。

• 支援有狀態與無狀態的 Actor 互動模式，包含自動重連與事件訂閱的穩健連線生命週期管理。

• 進階 RPC 能力，支援直接呼叫動作以及針對特定 Actor 實作的低階 WebSocket 或 HTTP fetch 互動。

• 複雜資料處理功能，透過結構化鍵值來防止注入攻擊，並確保 Actor 實例的安全階層式定址。

• 支援透過 params 與 getParams 進行動態身份驗證與連線參數設定，適用於安全權杖輪替與 JWT 管理。

• 當您需要定義應用程式如何與 Rivet 執行階段互動以確保高並發與低延遲時，請使用此技能。

• 請遵循快速失敗的錯誤處理原則以維持應用程式穩定性；利用 ActorError 類別針對失敗的動作或拒絕的連線取得細部回饋。

• 實作時，請確保正確匯入 Actor 註冊表，以充分利用 TypeScript 的型別安全性，確保客戶端與伺服器邊界的一致性。

• 請密切留意 onOpen、onClose 與 onStatusChange 等連線生命週期事件，以便在分散式環境中提供靈敏的用戶體驗。

• 使用提供的後端呼叫模式，將 RivetKit Actors 與現有的 HTTP 框架（如 Hono、Express 或 Elysia）進行整合。