@datadog/openfeature-node-server

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

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

中文使用文档
文档目录3 节
  1. 独立的配置助手
  2. 获取选项和错误
  3. 最终用户许可证协议

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

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

独立的配置助手

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

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.

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

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

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

版本与发布记录

@datadog/openfeature-node-server 共发布 33 个版本,首次发布于 2025/09/23;过去 12 个月发布了 21 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.7.0latest2026/10/3012 天前
2.6.02026/10/2814 天前
2.5.02026/10/1527 天前
2.4.02026/09/241 个月前
2.3.02026/09/151 个月前
2.2.02026/08/222 个月前

其他发布通道:preview → 0.1.0-preview.14。

关于 @datadog/openfeature-node-server 的常见问题

@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 和提交记录判断。