@appsignal/react

中文文档
1.0.31发布于 2025/09/30MITTypeScriptESM + CJS近 30 天下载 13.8万
  • [AppSignal.com网站] - [文件][docs] - [支持][接触]
中文使用文档
文档目录10 节
  1. 安装
  2. 使用量
  3. 错误边界
  4. 遗留边界
  5. 发展
  6. 安装
  7. 测试
  8. 版本
  9. 捐款
  10. 支助

@appsignal/react

这个 @appsignal/javascript react v15+的集成.

另见 单重播读取器 更多信息.

安装

添加数据 @appsignal/react 财务报告和审定财务报表 @appsignal/javascript 给您的软件包 package.json运行 yarn install编号 :npm install。 。 。 .

您也可以将这些软件包添加到您的 package.json 在命令行上 :

yarn add @appsignal/javascript @appsignal/react
npm install --save @appsignal/javascript @appsignal/react

使用量

错误边界

如果您正在使用 React v16 或更高,您可以使用 ErrorBoundary 组件以捕捉儿童组件树中任何地方的错误.

import React from "react"
import ReactDOM from "react-dom"
import Appsignal from "@appsignal/javascript"
import { ErrorBoundary } from "@appsignal/react"

const appsignal = new Appsignal({
  key: "YOUR FRONTEND API KEY"
})

const FallbackComponent = () => (
  <div>Uh oh! There was an error :(</div>
)

const App = () => (
  <ErrorBoundary instance={appsignal} fallback={(error) => <FallbackComponent />}>
    { /** Child components here **/}
  </ErrorBoundary>
)

ReactDOM.render(<App />, document.getElementById("root"))

遗留边界

⚠️ 警报: 该组件使用的API在React的开发中此时不稳定. 我们提出这个部分作为支持那些运行React v15的工具,但并不保证它的再联络. 鼓励您使用 ErrorBoundary 只要可能,就应该.

这个 LegacyBoundary 几乎完全一样 ErrorBoundary数字 :

import React from "react"
import ReactDOM from "react-dom"
import Appsignal from "@appsignal/javascript"
import { LegacyBoundary } from "@appsignal/react"

const appsignal = new Appsignal({ 
  key: "YOUR FRONTEND API KEY"
})

const FallbackComponent = () => (
  <div>Uh oh! There was an error :(</div>
)

const App = () => (
  <LegacyBoundary instance={appsignal} fallback={(error) => <FallbackComponent />}>
    { /** Child components here **/}
  </LegacyBoundary>
)

ReactDOM.render(<App />, document.getElementById("root"))

发展

安装

确保安装单机 和靴子,看看 项目README的开发部分 更多信息.

您可以运行以下操作以启动编译器 监视 模式。 自动编译 ES 模块和 CommunityJS 变体:

yarn build:watch

您也可以不查看目录而构建库 :

yarn build        # build both CJS and ESM
yarn build:cjs    # just CJS
yarn build:esm    # just ESM

测试

此库的测试 欢乐 作为测试跑者。 一旦您安装了依赖性, 您可以在这个寄存器的根部运行以下命令来运行所有软件包的测试, 或者在只运行与该软件包有关的测试的软件包目录中运行 :

yarn test

版本

此还原使用 语义版本 (通常称为 铸造) (中文(简体) ). 寄存器中的每个软件包都是相互独立的版本.

@TODO:一旦我们更了解释放

捐款

考虑为这次再投资做贡献? 赞

请跟我们走 贡献指南 我们的文件,并跟着我们 行为守则。 。 。 .

而且,我们很乐意给你送来斯多普瓦夫斯 看看每个人,我们发送一个包裹 到目前为止,我们 Stroopwafles 页面。 。 。 .

支助

联系我们 直接和AppSignal的工程师交谈 他们会帮助你得到设置, 调整你的代码 并确保你得到最多的 使用AppSignal.

版本与发布记录

@appsignal/react 共发布 40 个版本,首次发布于 2019/07/03;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.0.31latest2025/09/301.1 年前
1.0.302025/07/211.3 年前
1.0.292025/01/031.8 年前
1.0.282024/11/122 年前
1.0.272024/10/012 年前
1.0.262024/07/032 年前

关于 @appsignal/react 的常见问题

@appsignal/react 是什么?

[AppSignal.com网站] - [文件][docs] - [支持][接触]

如何安装 @appsignal/react?

在项目目录运行 npm install @appsignal/react,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>= 16.8.6 < 20)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@appsignal/react 支持 TypeScript 吗?

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

@appsignal/react 支持 ESM 还是 CommonJS?

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

@appsignal/react 可以商用吗?

@appsignal/react 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@appsignal/react 的下载量有多少?

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

@appsignal/react 还在维护吗?

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