```
- `enableTracking`: 设定为 `false` 停止向 Bucket 发送跟踪事件和用户/公司更新。 假冒用户时有用(默认为 `true`, (中文(简体) ),
- `apiBaseUrl`: Bucket API 的可选基址 。 使用此选项来覆盖默认 API 端点,
- `appBaseUrl`: Bucket 应用程序的可选基址. 使用此功能来覆盖默认的应用程序 URL,
- `sseBaseUrl`: 服务器-恒星事件的可选基址. 用它来覆盖默认的 SSE 端点,
- `debug`: 设定为 `true` 启用调试日志到控制台,
- `toolbar`: 可选 [配置](https://docs.bucket.co/supported-languages/browser-sdk/globals#toolbaroptions) 为 Bucket 工具栏,
- `feedback`: 反馈收集的可选配置
## 钩子
### `useFeature()`
返回当前上下文的给定特性状态。 钩子为特征旗帜及其配置提供了类型安全访问.
```tsx
import { useFeature } from "@bucketco/react-sdk";
function StartHuddleButton() {
const {
isLoading, // true while features are being loaded
isEnabled, // boolean indicating if the feature is enabled
config: {
// feature configuration
key, // string identifier for the config variant
payload, // type-safe configuration object
},
track, // function to track feature usage
requestFeedback, // function to request feedback for this feature
} = useFeature("huddle");
if (isLoading) {
return ;
}
if (!isEnabled) {
return null;
}
return (
<>
);
}
```
### `useTrack()`
`useTrack()` 让您向 Bucket 发送自定义事件 。 用户使用此选项 _用途_ 一个功能。 创建 [特性](https://docs.bucket.co/introduction/concepts/feature) 在 Bucket 中,基于这些事件分析特性使用. 返回向 Bucket 发送自定义事件的函数 。 用户使用此选项 _用途_ 一个功能。 这些事件可用于分析地物用法,并创造出巴克特的新地物.
```tsx
import { useTrack } from "@bucketco/react-sdk";
function StartHuddle() {
;
}
```
### `useRequestFeedback()`
返回一个函数,让您打开一个对话框来请求对特定特性的反馈。 这有助于收集关于具体特征的有针对性的反馈.
`useRequestFeedback()` 返回允许您打开对话框的函数,以询问特定特性的反馈. 见 [自动反馈调查](https://docs.bucket.co/product-handbook/live-satisfaction) 如何自动操作,没有代码.
使用时 `useRequestFeedback` 您必须将特性密钥传递到 `requestFeedback`。 。 。 . 以下示例说明如何使用 `position` 以确保弹出器出现在“反馈!”按钮旁边.
```tsx
import { useRequestFeedback } from "@bucketco/react-sdk";
function FeedbackButton() {
const requestFeedback = useRequestFeedback();
return (
);
}
```
见 [反馈文档](https://github.com/bucketco/bucket-javascript-sdk/blob/main/packages/browser-sdk/FEEDBACK.md#manual-feedback-collection) 更多信息,请访问infofinland上的 `requestFeedback` 选项.
### `useSendFeedback()`
返回允许您向 Bucket 发送反馈的函数。 如果你通过自己的UI手动收集到反馈,并想要将其发送到Bucket,这个是有用的.
```tsx
import { useSendFeedback } from "@bucketco/react-sdk";
function CustomFeedbackForm() {
const sendFeedback = useSendFeedback();
const handleSubmit = async (data: FormData) => {
await sendFeedback({
featureKey: "bucket-feature-key",
score: parseInt(data.get("score") as string),
comment: data.get("comment") as string,
});
};
return ;
}
```
### `useUpdateUser()`, (中文(简体) ), `useUpdateCompany()` 财务报告和审定财务报表 `useUpdateOtherContext()`
这些钩子返回函数可以使您更新当前设定的用户,公司或其他上下文的属性. 对用户/公司的更新被远程存储并影响特性瞄准,而"其他"上下文更新仅会影响当前会话.
```tsx
import {
useUpdateUser,
useUpdateCompany,
useUpdateOtherContext,
} from "@bucketco/react-sdk";
function FeatureOptIn() {
const updateUser = useUpdateUser();
const updateCompany = useUpdateCompany();
const updateOtherContext = useUpdateOtherContext();
const handleUserUpdate = async () => {
await updateUser({
role: "admin",
betaFeatures: "enabled",
});
};
const handleCompanyUpdate = async () => {
await updateCompany({
plan: "enterprise",
employees: 500,
});
};
const handleContextUpdate = async () => {
await updateOtherContext({
currentWorkspace: "workspace-123",
theme: "dark",
});
};
return (
);
}
```
注:更改 `user.id` 或者说 `company.id`,需要更新传递给 `BucketProvider` 而不是用这些钩子.
### `useClient()`
返回 `BucketClient` 用于 `BucketProvider`。客户端提供了更多的功能 无法直接进入其他钩子.
```tsx
import { useClient } from "@bucketco/react-sdk";
function LoggingWrapper({ children }: { children: ReactNode }) {
const client = useClient();
useEffect(() => {
client.on("check", (evt) => {
console.log(`The feature ${evt.key} is ${evt.value} for user.`);
});
}, [client]);
return children;
}
```
## 内容安全政策
见 [社区支助方案](https://github.com/bucketco/bucket-javascript-sdk/blob/main/packages/browser-sdk/README.md#content-security-policy-csp) 用于使用 Bucket React SDK 和 CSP 的信息
## 许可证
MIT 许可证
版权(c)2025 Bucket Aps
## 常见问题
### @bucketco/react-sdk 是什么？
反应客户端库 Bucket\.co \(英语\)注意：该包已被作者标记为弃用——This package has been moved to @reflag/react-sdk\. Please upgrade\.
### 如何安装 @bucketco/react-sdk？
在项目目录运行 npm install @bucketco/react-sdk，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\*）、react-dom（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
### @bucketco/react-sdk 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @bucketco/react-sdk 支持 ESM 还是 CommonJS？
同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。
### @bucketco/react-sdk 可以商用吗？
@bucketco/react-sdk 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @bucketco/react-sdk 的下载量有多少？
根据 npm 官方下载统计，@bucketco/react-sdk 在 2026/10/09 – 2026/11/07 这 30 天内被下载 3,511 次，日均约 117 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @bucketco/react-sdk 还在维护吗？
最新版本 3\.3\.3 发布于 2025/08/26（1\.2 年前）；至今共发布 42 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/06/14。作者已将其标记为弃用，新项目建议寻找替代方案。