Examples

These samples run on workerd on this node. Cloudflare geolocation / country-code examples depend on global Anycast and request.cf.country. That edge-geo product is not provided.

Hello JSON

Same hello-worker as Get started.

export default {
  fetch(request: Request, env: Env): Response {
    return Response.json({
      message: env.GREETING,
      pathname: new URL(request.url).pathname,
    });
  },
} satisfies ExportedHandler<Env>;

{
  "name": "hello-typescript",
  "main": "src/index.ts",
  "vars": { "GREETING": "Hello from TypeScript" }
}

KV get / put

The Worker-side KV API matches KV. Authority is a SQLite database on this node. Global replication is not provided.

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const url = new URL(request.url);
    if (request.method === "PUT") {
      await env.KV.put("hello", await request.text());
      return new Response("ok");
    }
    return new Response((await env.KV.get("hello")) ?? "missing");
  },
} satisfies ExportedHandler<Env>;

{
  "name": "kv-demo",
  "main": "src/index.ts",
  "bindings": {
    "KV": { "type": "kv_namespace", "id": "<kv-namespace-id>" }
  }
}

id is an existing KV namespace on the platform, not a name placeholder.

Cron scheduled handler

The Cron product lives at Cron Triggers. The handler matches Cloudflare scheduled().

export default {
  fetch(): Response {
    return new Response("cron worker");
  },
  async scheduled(controller: ScheduledController, env: Env, ctx: ExecutionContext): Promise<void> {
    console.log(controller.cron, controller.scheduledTime);
  },
} satisfies ExportedHandler<Env>;

Expressions are five UTC fields plus the documented local Quartz-like extensions. On misfire, recovery projects at most the latest slot within grace. The platform deployment metadata field is crons (string array). open-compute.json has no Wrangler triggers key; adding one is an unknown field and fails.

Service Binding fetch

Fetch / RPC between Workers in the same platform account. See bindings.

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    return env.UPSTREAM.fetch(request);
  },
} satisfies ExportedHandler<Env>;

{
  "name": "front",
  "main": "src/index.ts",
  "services": [
    { "binding": "UPSTREAM", "service": "hello-typescript" }
  ]
}

The target Worker name is resolved and frozen as a target ID at deploy time. Service Bindings are same-platform only. Cross-region discovery is not provided.

Compatibility

Topic	Cloudflare	open-compute
Module handlers, KV get/put, scheduled, Service Binding fetch	Yes	Yes
request.cf.country edge geo / geolocation samples	Yes	Not provided
workers.dev	Yes	Not provided
Analytics Engine / Workers AI / Turnstile samples	Yes	Not provided
Where state lives	Global replication products	This node

Next: Configuration, Runtime APIs.