# RivetKit JavaScript 客户端在构建使用“rivetkit/client”连接到 Rivet Actors 的 JavaScript 客户端（浏览器、Node.js 或 Bun）时，请使用此技能。 ## 第一步 1.安装客户端（最新：2.1.6） npm 安装 rivetkit@2.1.6 2. 使用 createClient() 创建客户端并调用 actor 操作。 ## 错误处理策略 * 默认情况下更喜欢快速失败行为。 * 除非绝对需要，否则避免使用“try/catch”。 * 如果使用了“catch”，请显式处理错误，至少通过记录错误来处理。 ## 开始使用请参阅[后端快速入门指南]()以开始使用。 ## 最小客户端从“rivetkit/client”导入{createClient}；从“./actors”导入类型{registry}； const client = createClient<注册表类型>({ 端点：“https://my-namespace:pk_...@api.rivet.dev”， }); const counter = client.counter.getOrCreate(["my-counter"]); const count = 等待 counter.increment(1); 从“rivetkit”导入 { actor, setup }；导出常量计数器 = actor({ 状态：{计数：0}，行动：{ 增量：（c，x：数字）=> { c.state.count += x; 返回c.state.count； }, }, }); 导出常量注册表=设置（{ 使用：{计数器}， }); ## 无状态与有状态从“rivetkit/client”导入{createClient}；常量客户端 = createClient(); const handle = client.counter.getOrCreate(["my-counter"]); // 无状态：每次调用都是独立的等待句柄.increment(1); // 有状态：为实时事件保持连接打开 const conn = handle.connect(); conn.on("count", (value) => console.log(value)); 等待 conn.increment(1); ## 获取演员从“rivetkit/client”导入{createClient}；常量客户端 = createClient(); const room = client.chatRoom.getOrCreate(["room-42"]); const现有 = client.chatRoom.get(["room-42"]); const 创建=等待 client.game.create(["game-1"], { 输入：{ 模式：“排名” }， }); const byId = client.chatRoom.getForId("演员 ID"); constsolvedId = 等待 room.resolve(); ## 连接参数从“rivetkit/client”导入{createClient}；常量客户端 = createClient(); const chat = client.chatRoom.getOrCreate(["一般"], { params: { authToken: "jwt-token-here" }, }); const conn = chat.connect(); ## 订阅活动从“rivetkit/client”导入{createClient}；常量客户端 = createClient(); const conn = client.chatRoom.getOrCreate(["general"]).connect(); conn.on("消息", (msg) => console.log(msg)); conn.once("gameOver", () => console.log("完成")); ## 连接生命周期从“rivetkit/client”导入{createClient}；常量客户端 = createClient(); const conn = client.chatRoom.getOrCreate(["general"]).connect(); conn.onOpen(() => console.log("已连接")); conn.onClose(() => console.log("已断开连接")); conn.onError((err) => console.error("错误：", err)); conn.onStatusChange((status) => console.log("状态：", status)); 等待 conn.dispose(); ## 低级 HTTP 和 WebSocket 对于实现了`onRequest`或`onWebSocket`的actor，直接调用它们：从“rivetkit/client”导入{createClient}；常量客户端 = createClient(); const 句柄 = client.chatRoom.getOrCreate(["general"]); const response =等待handle.fetch(“历史记录”); const 历史记录=等待response.json(); const ws =等待handle.webSocket(“stream”); ws.addEventListener("消息", (事件) => { console.log("消息：", event.data); }); ws.send("你好"); ## 从后端调用从“hono”导入{Hono}；从“rivetkit/client”导入{createClient}； const app = new Hono(); 常量客户端 = createClient(); app.post("/increment/:name", async (c) => { const counterHandle = client.counter.getOrCreate([c.req.param("name")]); const newCount = 等待 counterHandle.increment(1); 返回 c.json({ count: newCount }); }); ## 错误处理从“rivetkit/client”导入 { ActorError }；从“rivetkit/client”导入{createClient}；常量客户端 = createClient(); 尝试{ 等待 client.user.getOrCreate(["user-123"]).updateUsername("ab"); } 捕获（错误）{ if (ActorError 的错误实例) { console.log(错误.代码, 错误.元数据); } } ## 概念 ### 键键唯一地标识参与者实例。使用复合键（数组）进行分层寻址：从“rivetkit/client”导入{createClient}；从“./actors”导入类型{registry}； const client = createClient<注册表类型>(); // 复合键: [org, room] client.chatRoom.getOrCreate(["org-acme", "general"]); 从“rivetkit”导入 { actor, setup }；导出 const chatRoom = 演员({ 状态：{消息：[]作为字符串[]}，行动：{ getRoomInfo: (c) => ({ org: c.key[0], room: c.key[1] }), }, }); 导出常量注册表=设置（{ 使用：{聊天室}， }); 当 `userId` 包含用户数据时，不要使用字符串插值构建键，如 `"org:${userId}"`。使用数组来防止密钥注入攻击。 ### 环境变量 `createClient()` 自动读取： * `RIVET_ENDPOINT`（端点） * `RIVET_NAMESPACE` * `RIVET_TOKEN` * `RIVET_RUNNER` 未设置时默认为浏览器中的 `window.location.origin + "/api/rivet"` 或服务器上的 `http://127.0.0.1:6420`。 ### 端点格式端点支持 URL 身份验证语法： https://命名空间:token@api.rivet.dev 您还可以在没有身份验证的情况下传递端点，并分别提供“RIVET_NAMESPACE”和“RIVET_TOKEN”。对于无服务器部署，请使用应用程序的“/api/rivet” URL。有关详细信息，请参阅 [Endpoints]()。 ## API 参考 **软件包：** [rivetkit]() 请参阅 [RivetKit 客户端概述]()。 * [`createClient`]() \- 创建客户端 * [`createEngineDriver`]() \- 引擎驱动程序 * [`DriverConfig`]() \- 驱动配置 * [`Client`]() \- 客户端类型 ## 需要的不仅仅是客户？如果您需要有关 Rivet Actors、注册表或服务器端 RivetKit 的更多信息，请添加主要技能： npx 技能添加 rivet-dev/skills 然后使用`rivetkit`技能进行后端指导。

Rivetkit 客户端 JavaScript

包含技能