durable-objects

Build stateful, coordinated applications on Cloudflare's edge with persistent storage and RPC methods.

- Designed for coordination patterns: chat rooms, multiplayer games, booking systems, and per-entity state management using deterministic routing via getByName()

- Includes SQLite storage with synchronous sql.exec(), KV storage, alarms for scheduled per-entity work, and WebSocket support

- Provides RPC method calls (preferred over fetch handlers), blockConcurrencyWhile() for initialization, and parent-child DO relationships for sharding

- Covers wrangler configuration, migrations, Workers integration, and testing with Vitest; biases toward live Cloudflare docs over pre-trained knowledge

Durable Objects

Build stateful, coordinated applications on Cloudflare's edge using Durable Objects.

Retrieval Sources

Your knowledge of Durable Objects APIs and configuration may be outdated. Prefer retrieval over pre-training for any Durable Objects task.

Resource
URL

Docs
https://developers.cloudflare.com/durable-objects/

API Reference
https://developers.cloudflare.com/durable-objects/api/

Best Practices
https://developers.cloudflare.com/durable-objects/best-practices/

Examples
https://developers.cloudflare.com/durable-objects/examples/

Fetch the relevant doc page when implementing features.

When to Use