Service bindings - HTTP · Cloudflare Workers ドキュメント

Worker A が Worker B への Service binding を宣言している場合、バインディングオブジェクトに公開されている fetch() メソッドを呼び出すと、Request オブジェクトを Worker B へ転送できます。

たとえば、次の Worker は fetch() ハンドラーを実装しています。

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"name": "worker_b",
	"main": "./src/workerB.js"
}

"$schema" = "./node_modules/wrangler/config-schema.json"
name = "worker_b"
main = "./src/workerB.js"

export default {
  async fetch(request, env, ctx) {
    return new Response("Hello World!");
  }
}

次の Worker は、上記の Worker へのバインディングを宣言しています。

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"name": "worker_a",
	"main": "./src/workerA.js",
	"services": [
		{
			"binding": "WORKER_B",
			"service": "worker_b"
		}
	]
}

"$schema" = "./node_modules/wrangler/config-schema.json"
name = "worker_a"
main = "./src/workerA.js"

[[services]]
binding = "WORKER_B"
service = "worker_b"

そして、リクエストを転送できます。

export default {
	async fetch(request, env) {
		return await env.WORKER_B.fetch(request);
	},
};

Note

既存のリクエストを転送するのではなく、新しいリクエストを手動で組み立てる場合は、ホスト名を含む有効で完全修飾の URL を指定してください。例:

export default {
  async fetch(request, env) {
    // provide a valid URL
    let newRequest = new Request("https://valid-url.com", { method: "GET" });
    let response = await env.WORKER_B.fetch(newRequest);
    return response;
  }
};