节点.js SDK 用于调理特性旗
使用此 README 开始为 Node. 这份指南概述了获得 从SDK开始,并提供一个完整的代码样本供您试用.
此样本不包括配置选项, 用于深度步骤和配置 SDK, 例如功能失效 流出或使用我们的中继代理服务器,参见 节点.js SDK 参考。 。 。 .
所需资源
要使用 SDK , 请确定您是否:
- 安装了 Node.js v12 或更新版本
与我们的测试代码样本一样
- 在哈内斯平台上创建了特性旗 调用
harnessappdemodarkmode - 创建服务器 SDK 密钥 并把它复制出来
安装 SDK
第一步是安装FF SDK作为应用程序中的依赖. 要使用 npm 安装,请使用 :
npm install @harnessio/ff-nodejs-server-sdk
或者用纱线安装,使用:
yarn add @harnessio/ff-nodejs-server-sdk
代码样本
下面是一个完整的代码示例,可以用来测试 harnessappdemodarkmode 您创建的旗帜
驾驭平台. 当你运行代码时,它会:
- 接通FF服务.
- 每10秒报告一旗的值,直到连接关闭.
- 听着,当
harnessappdemodarkmode旗子在Harness平台上切换或关闭,并报告新值.
const { Client, Event } = require('@harnessio/ff-nodejs-server-sdk');
(async () => {
// set apiKey to your SDK API Key
const apiKey = 'YOUR_FF_SDK_KEY';
// set flagName to your flag identifier from the UI
const flagName = 'harnessappdemodarkmode';
console.log('Harness SDK Getting Started');
// Create Client
const client = new Client(apiKey);
// Create a target (different targets can receive different results based on rules.
// Here we are including "location" as a custom attribute)
const target = {
identifier: 'nodeserversdk',
name: 'NodeServerSDK',
attributes: {
location: 'emea',
},
};
try {
await client.waitForInitialization();
} catch (e) {
console.log("Error when authenticating Feature Flags client: " + e)
}
try {
// Log the state of the flag every 10 seconds
setInterval(async () => {
const value = await client.boolVariation(flagName, target, false);
console.log('Flag variation:', value);
}, 10000);
// We can also watch for the event when a flag changes
client.on(Event.CHANGED, async (flagIdentifier) => {
const value = await client.boolVariation(flagIdentifier, target, false);
console.log(`${flagIdentifier} changed: ${value}`);
});
} catch (e) {
console.error('Error:', e);
}
})();
运行示例
要运行示例, 请执行您的脚本 :
node example.js
完成后,您可以通过使用 控制- 说吧c. 国家。 。 。 .
使用自定义 TLS 证书
如果使用不使用被广泛公开的预捆绑 CA 的代理或 SMP 实例, 您可以使用 tlsTrustedCa 选项.
此选项会选择一个路径到一个包含一组包含 PEM 格式证书的文件 。 如果存在此选项, HTTP 客户端将忽略
任何预捆绑的证书,所以您需要包含自定义证书的全部证书链.
const client = new Client(apiKey, {
baseUrl: 'https://ffserver:8000/api/1.0',
eventsUrl: 'https://ffserver:8001/api/1.0',
tlsTrustedCa: 'path_to_cert_chain.crt',
});
其他阅读
更多示例和配置选项,见 节点.js SDK 参考 编辑 测试节点.js项目。 。 。 . 关于"地物"旗的更多信息,参见我们 特性标记文档。 。 。 .