@bufbuild/connect-web

中文文档
0.13.0发布于 2023/08/18Apache-2.0TypeScriptESM + CJS近 30 天下载 6.3万

Connect是图书馆的一个家族,用于在不同语言和平台上建立和消费API. @ bufbuilding/ 连接 将带有Protobuf的安全型API带入TypeScript.

此软件包已被标记为弃用

Connect has moved to its own org @connectrpc and has a stable v1. Run `npx @connectrpc/connect-migrate@latest` to update. See https://github.com/connectrpc/connect-es/releases/tag/v0.13.1 for details.

中文使用文档
文档目录3 节
  1. 创建连接传输 ()
  2. 创建GrpcWeb Transport ()
  3. 开始

@ bufbuilding/ 连接- web

Connect是图书馆的一个家族,用于在不同语言和平台上建立和消费API. @ bufbuilding/ 连接 将带有Protobuf的 安全 API 带到 类型脚本 .

@bufbuild/connect-web 为 web 浏览器提供下列适配器,以及任何其它有 在机上获取 API :

创建连接传输 ()

让您的客户端在网络浏览器中运行, 用连接协议向服务器说话 :

import { createPromiseClient } from "@bufbuild/connect";
+ import { createConnectTransport } from "@bufbuild/connect-web";
import { ElizaService } from "./gen/eliza_connect.js";

+ // A transport for clients using the Connect protocol with fetch()
+ const transport = createConnectTransport({
+   baseUrl: "https://demo.connectrpc.com",
+ });

const client = createPromiseClient(ElizaService, transport);
const { sentence } = await client.say({ sentence: "I feel happy." });
console.log(sentence) // you said: I feel happy.

创建GrpcWeb Transport ()

让您的客户端在网页浏览器中运行, 用 gRPC-web 协议与服务器交谈 :

import { createPromiseClient } from "@bufbuild/connect";
+ import { createGrpcWebTransport } from "@bufbuild/connect-web";
import { ElizaService } from "./gen/eliza_connect.js";

+ // A transport for clients using the Connect protocol with fetch()
+ const transport = createGrpcWebTransport({
+   baseUrl: "https://demo.connectrpc.com",
+ });

const client = createPromiseClient(ElizaService, transport);
const { sentence } = await client.say({ sentence: "I feel happy." });
console.log(sentence) // you said: I feel happy.

开始

要开始连接,请前往 文档 用于教学,或查看 我们的榜样。 。 。 .

Connect与Vue,Svelte,Remix,Next.js,Angular等多家公司打出好牌. 看看这个 我们的榜样 用于各种框架.

版本与发布记录

@bufbuild/connect-web 共发布 38 个版本,首次发布于 2022/03/10;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.13.0latest2023/08/183 年前
0.12.02023/07/253 年前
0.11.02023/06/293 年前
0.10.12023/06/213 年前
0.10.02023/06/153 年前
0.9.12023/05/313 年前

关于 @bufbuild/connect-web 的常见问题

@bufbuild/connect-web 是什么?

Connect是图书馆的一个家族,用于在不同语言和平台上建立和消费API. @ bufbuilding/ 连接 将带有Protobuf的安全型API带入TypeScript.注意:该包已被作者标记为弃用——Connect has moved to its own org @connectrpc and has a stable v1. Run `npx @connectrpc/connect-migrate@latest` to update. See https://github.com/connectrpc/connect-es/releases/tag/v0.13.1 for details.

如何安装 @bufbuild/connect-web?

在项目目录运行 npm install @bufbuild/connect-web,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@bufbuild/protobuf(^1.2.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bufbuild/connect-web 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bufbuild/connect-web 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@bufbuild/connect-web 可以商用吗?

@bufbuild/connect-web 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@bufbuild/connect-web 的下载量有多少?

根据 npm 官方下载统计,@bufbuild/connect-web 在 2026/10/09 – 2026/11/07 这 30 天内被下载 63,095 次,日均约 2,103 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bufbuild/connect-web 还在维护吗?

最新版本 0.13.0 发布于 2023/08/18(3 年前);至今共发布 38 个版本,其中过去 12 个月发布了 0 个;首次发布于 2022/03/10。作者已将其标记为弃用,新项目建议寻找替代方案。