版本元数据

版本元数据绑定可用于从 Workers 运行时内部访问与版本关联的元数据。

Worker 版本 ID、版本标签和版本创建时间戳可通过版本元数据绑定获取。它们可用于发送到 Workers Analytics Engine 的事件，或发送到任何第三方分析/指标服务，以便按 Worker 版本进行聚合。

要使用版本元数据绑定，请更新 Worker 的 Wrangler 文件：

{
	"version_metadata": {
		"binding": "CF_VERSION_METADATA"
	}
}

[version_metadata]
binding = "CF_VERSION_METADATA"

Interface

以下示例展示如何从 Worker 内部访问版本 ID 和版本标签，以将事件发送到 Workers Analytics Engine：

export default {
  async fetch(request, env, ctx) {
    const { id: versionId, tag: versionTag, timestamp: versionTimestamp } = env.CF_VERSION_METADATA;
    env.WAE.writeDataPoint({
      indexes: [versionId],
      blobs: [versionTag, versionTimestamp],
      //...
    });
    //...
  },
};

interface Environment {
  CF_VERSION_METADATA: WorkerVersionMetadata;
  WAE: AnalyticsEngineDataset;
}

export default {
  async fetch(request, env, ctx) {
    const { id: versionId, tag: versionTag } = env.CF_VERSION_METADATA;
    env.WAE.writeDataPoint({
      indexes: [versionId],
      blobs: [versionTag],
      //...
    });
    //...
  },
} satisfies ExportedHandler<Env>;