# @datadog/openfeature-node-server 中文文档

规范地址：https://npmcn.com/package/%40datadog/openfeature-node-server/

版本：2\.7\.0
npm 元数据更新时间：2026-10-29T18:49:11.461Z
中文译文更新时间：2026-11-11T13:23:53.249Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40datadog/openfeature-node-server
原文对照：https://npmcn.com/package/%40datadog/openfeature-node-server/?lang=original
项目主页：https://github.com/DataDog/openfeature-js-client#readme
源码仓库：https://github.com/DataDog/openfeature-js-client

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：182 kB，109 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：1 个
- 首次发布：2025-09-23T13:09:22.693Z
- 最新版本发布：2026-10-29T18:49:11.017Z
- 近 30 天下载量：23515670（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 21 个）

## 中文简介

节点.js 服务器绑定 OpenFeature (wraps @ datadog/ flaging-core)

## 安装

```sh
npm install @datadog/openfeature-node-server
```

也可以使用：`pnpm add @datadog/openfeature-node-server`、`yarn add @datadog/openfeature-node-server`、`bun add @datadog/openfeature-node-server`

## README

# 数据犬 OpenFeature 节点.js 服务器客户端

这个软件包为Node.js服务器环境提供OpenFeature集成,专为内部Datadog使用而设计. 不为外部组织或第三方使用提供支助.

## 独立的配置助手

要求节点.js 18或更新. 在不初始化跟踪器或提供者的情况下获取并解析规则 。 客人们 `dd-trace/openfeature` 入站点是单独的后续;这些示例使用内部包.

```javascript
import { fetchRulesConfiguration, configurationToString } from '@datadog/openfeature-node-server/rules-based'

// The server distribution channel is the default. Rules do not depend on an evaluation context.
const configuration = await fetchRulesConfiguration({ apiKey, env: 'production' })

// For browser bootstrap data, explicitly fetch client-distributed rules.
const clientConfiguration = await fetchRulesConfiguration({
  distributionChannel: 'client',
  clientToken,
  env: 'production',
})
const wire = configurationToString(clientConfiguration)
// Pass wire through the framework's safe SSR data serializer, not raw inline HTML.
```

**只向浏览器转发客户端分布配置.** 串行化不会去除只包含服务器的旗帜. 客户端的出入口控制和选入要求仍然适用.

从序列化配置初始化浏览器提供者 :

```javascript
import { configurationFromString, DatadogCoreProvider } from '@datadog/openfeature-browser/rules-based'
import { OpenFeature } from '@openfeature/web-sdk'

const provider = new DatadogCoreProvider()
provider.setConfiguration(configurationFromString(wire))
await OpenFeature.setProviderAndWait(provider, context)
```

回来的 `FlagsConfiguration` 实值 **没有** (原始内容存档于2013-10-10). UNESC JSON 接受的遗赠 `DatadogNodeServerProvider.setConfiguration()`。现有的节点提供者没有改变,从根入点导入它不会装入原发泡解码器.

### 获取选项和错误

-   `distributionChannel` 选择要获取的配置通道,而不是帮助者运行的地方。 默认为 `server`; 使用 `client` 在为浏览器或移动 SDK 准备配置时.
-   `site` 默认为 `datadoghq.com`。 。 。 .
-   `fetch` 覆盖全局获取 。 自定义运输必须尊重 `signal` 财务报告和审定财务报表 `redirect: 'manual'`; 拒绝重新定向以保护证书.
-   `timeoutMs` 默认为 `5000` 并覆盖请求和答复机构. `signal` 支持呼叫者取消和较早的最后期限.
-   失败投出 `ConfigurationFetchError` 带有 `code` 对于HTTP错误, `status`。超时使用 `timeout`; 使用其他调用者的取消 `cancelled`。 。 。 .

申请拥有复试,投票,存储,跟踪,倒置等功能.

## 最终用户许可证协议

[https://www.datadoghq.com/legal/eula 互联网档案馆的存檔,存档日期2013-12-02](https://www.datadoghq.com/legal/eula)

## 常见问题

### @datadog/openfeature-node-server 是什么？

节点\.js 服务器绑定 OpenFeature \(wraps @ datadog/ flaging-core\)

### 如何安装 @datadog/openfeature-node-server？

在项目目录运行 npm install @datadog/openfeature-node-server，或使用 pnpm add / yarn add / bun add。

### @datadog/openfeature-node-server 支持 TypeScript 吗？

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

### @datadog/openfeature-node-server 支持 ESM 还是 CommonJS？

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

### @datadog/openfeature-node-server 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @datadog/openfeature-node-server 可以商用吗？

@datadog/openfeature-node-server 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @datadog/openfeature-node-server 的下载量有多少？

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

### @datadog/openfeature-node-server 还在维护吗？

最新版本 2\.7\.0 发布于 2026/10/30（12 天前）；至今共发布 33 个版本，其中过去 12 个月发布了 21 个；首次发布于 2025/09/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。