Binding API

Workers は、Wrangler 設定ファイルに追加するバインディング経由で Flagship にアクセスします。binding フィールドで、Worker コード内で使う変数名を設定します。

{
	"flagship": [
		{
			"binding": "FLAGS",
			"app_id": "<APP_ID>",
		},
	],
}

[[flagship]]
binding = "FLAGS"
app_id = "<APP_ID>"

<APP_ID> を Flagship アプリのアプリ ID に置き換えます。まだアプリを作成していない場合は、使いはじめガイドを参照してください。この設定では、バインディングは env.FLAGS として使えます。複数アプリへのバインディングなど、追加のオプションは設定を参照してください。

バインディングは、フィーチャーフラグを評価するための型安全なメソッドを提供します。評価に失敗した場合やフラグが見つからない場合は、指定したデフォルト値を返します。

export default {
	async fetch(request, env) {
		const enabled = await env.FLAGS.getBooleanValue("new-feature", false, {
			userId: "user-42",
		});
		return new Response(enabled ? "Feature on" : "Feature off");
	},
};

export default {
	async fetch(request: Request, env: Env): Promise<Response> {
		const enabled = await env.FLAGS.getBooleanValue("new-feature", false, {
			userId: "user-42",
		});
		return new Response(enabled ? "Feature on" : "Feature off");
	},
};

バインディングの型は、@cloudflare/workers-types パッケージの Flagship です。