@flags-sdk/launchdarkly

中文文档
1.1.1发布于 2026/08/12MITTypeScriptESM + CJS构建来源已验证近 30 天下载 8.1万

旗舰 SDK 的暗向提供者

中文使用文档
文档目录5 节
  1. 设置
  2. 提供者实例
  3. 示例
  4. 自定义适配器
  5. 文档

旗帜 SDK - 发射暗色提供者

这个 启动暗向提供者 联 合 国 旗帜 SDK 包含对 LaunchDarkly 特性旗的支持.

设置

Statsig 供应商可在 @flags-sdk/statsig 模块。 你可以安装它

npm i @flags-sdk/launchdarkly

提供者实例

注: 这个 启动暗黑Vercel集成 必须在您的账户上安装, 因为这个适配器从 Global Config 中装入 Darkly 。 没有Global Config,适配器无法被使用.

导入默认适配器实例 ldAdapter 从 @flags-sdk/launchdarkly数字 :

import { ldAdapter } from "@flags-sdk/launchdarkly";

默认适配器使用下列环境变量来配置自己:

export LAUNCHDARKLY_CLIENT_SIDE_ID="612376f91b8f5713a58777a1"
export LAUNCHDARKLY_PROJECT_SLUG="my-project"
# Provided by the LaunchDarkly Marketplace integration when Global Config is
# enabled for the collection.
export EXPERIMENTATION_CONFIG="https://global-config.vercel.com/ecfg_abdc1234?token=xxx-xxx-xxx"

利用遗留下来的"暗地里Vercel集成"? 默认适配器读取 全局配置连接字符串 EXPERIMENTATION_CONFIG 只有这个 狦 工程提供连接字符串为 GLOBAL_CONFIG设置 EXPERIMENTATION_CONFIG 以相同值,或以 createLaunchDarklyAdapter。 。 。 .

示例

import { flag, dedupe } from "flags/next";
import { ldAdapter, type LDContext } from "@flags-sdk/launchdarkly";

const identify = dedupe(async (): Promise<LDContext> => {
  return {
    key: "user_123",
  };
});

export const showBanner = flag<boolean, LDContext>({
  key: "show-banner",
  identify,
  adapter: ldAdapter.variation(),
});

自定义适配器

使用 createLaunchDarklyAdapter 函数 :

import { createLaunchDarklyAdapter } from "@flags-sdk/launchdarkly";

const adapter = createLaunchDarklyAdapter({
  projectSlug: "my-project",
  clientSideId: "612376f91b8f5713a58777a1",
  // Legacy integrations that provide the connection string as `GLOBAL_CONFIG`
  // can pass it explicitly here.
  globalConfigConnectionString:
    process.env.EXPERIMENTATION_CONFIG ?? process.env.GLOBAL_CONFIG,
});

文档

请检查一下 启动黑暗提供者文档 更多信息.

版本与发布记录

@flags-sdk/launchdarkly 共发布 23 个版本,首次发布于 2024/12/13;过去 12 个月发布了 3 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.1.1latest2026/08/123 个月前
1.1.02026/08/053 个月前
1.0.02026/07/104 个月前
0.3.42025/11/061 年前
0.3.4-fcec5ecd-20251106144952snapshot2025/11/061 年前
0.3.32025/10/251.1 年前

关于 @flags-sdk/launchdarkly 的常见问题

@flags-sdk/launchdarkly 是什么?

旗舰 SDK 的暗向提供者

如何安装 @flags-sdk/launchdarkly?

在项目目录运行 npm install @flags-sdk/launchdarkly,或使用 pnpm add / yarn add / bun add。

@flags-sdk/launchdarkly 支持 TypeScript 吗?

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

@flags-sdk/launchdarkly 支持 ESM 还是 CommonJS?

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

@flags-sdk/launchdarkly 可以商用吗?

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

@flags-sdk/launchdarkly 的下载量有多少?

根据 npm 官方下载统计,@flags-sdk/launchdarkly 在 2026/10/15 – 2026/11/13 这 30 天内被下载 80,872 次,日均约 2,696 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@flags-sdk/launchdarkly 还在维护吗?

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