@electric-sql/react

中文文档
1.0.57发布于 2026/09/09Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 14.4万

电源SQL反应钩

中文使用文档

电气SQL 反应集成

Electric是现代应用程序的Postgres同步.

Electric为Postgres提供HTTP接口,使大量客户端能够查询并获得"形状"即数据库子集中数据的实时更新. 电能将Postgres变成实时数据库.

这个软件包会显示一个 useShape 将形状数据拖入您反应组件的钩子 .

Shapes 财务报告和审定财务报表 ShapeStreams 实例在全球范围被缓存,因此在多个组件中重新使用形状是便宜的.

安装

npm i @electric-sql/react

如何使用

添加 useShape 改为组件

import { useShape } from '@electric-sql/react'

export default function MyComponent() {
  const { isLoading, data } = useShape({
    url: 'http://my-api.com/shape',
    params: {
      table: `foo`,
    },
  })

  if (isLoading) {
    return <div>loading</div>
  }

  return (
    <div>
      {data.map((foo) => (
        <div>{foo.title}</div>
      ))}
    </div>
  )
}

版本与发布记录

@electric-sql/react 共发布 102 个版本,首次发布于 2024/07/18;过去 12 个月发布了 39 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.0.57latest2026/09/092 个月前
1.0.562026/09/012 个月前
1.0.552026/08/142 个月前
1.0.542026/08/043 个月前
1.0.532026/07/084 个月前
1.0.522026/07/024 个月前

其他发布通道:beta → 1.0.0-beta.6。

关于 @electric-sql/react 的常见问题

@electric-sql/react 是什么?

电源SQL反应钩

如何安装 @electric-sql/react?

在项目目录运行 npm install @electric-sql/react,或使用 pnpm add / yarn add / bun add。

@electric-sql/react 支持 TypeScript 吗?

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

@electric-sql/react 支持 ESM 还是 CommonJS?

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

@electric-sql/react 可以商用吗?

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

@electric-sql/react 的下载量有多少?

根据 npm 官方下载统计,@electric-sql/react 在 2026/10/14 – 2026/11/12 这 30 天内被下载 143,808 次,日均约 4,794 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@electric-sql/react 还在维护吗?

最新版本 1.0.57 发布于 2026/09/09(2 个月前);至今共发布 102 个版本,其中过去 12 个月发布了 39 个;首次发布于 2024/07/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。