实验注释

此 API 允许特权 JavaScript 使用客户端参与的任何实验来注释环境。

实验注释将与包含环境数据的任何 Ping 一起发送。

JS API

特权 JavaScript 代码可以使用 TelemetryEnvironment.sys.mjs 公开的函数来注释实验。

以下函数为提供的 id、branch 和 options 向环境添加注释。使用相同的 id 重复调用此函数将覆盖状态并触发新的子会话（受限流影响）。options 是一个对象，可能包含 type 用于为实验添加特定类型标签或 enrollmentId 用于为参与此实验的注册添加标识符标签。

TelemetryEnvironment.setExperimentActive(id, branch, [options={}}])

这将删除具有提供的 id 的实验的注释。

TelemetryEnvironment.setExperimentInactive(id)

这将同步返回一个字典，其中包含每个活动实验的信息。

TelemetryEnvironment.getActiveExperiments()

注意

setExperimentActive 和 setExperimentInactive 都会触发新的子会话。但是，后者仅在存在具有提供的 id 的活动实验时才会这样做。

限制

为了防止滥用，实验 id 和 branch 的内容长度限制为 100 个字符。 type 的长度限制为 20 个字符。 enrollmentId 的长度限制为 40 个字符（选择比 36 个字符长的 GUID 文本表示略长一些）。