cloudflare-durable-objects

Durable Objects provide globally unique, stateful coordination for real-time applications. Export a DO class, configure wrangler bindings, deploy migrations, and use RPC-style methods to manage per-object state across distributed Workers. Supports WebSocket hibernation, SQL/KV storage, and alarms for scheduling and state synchronization.

Yes. Durable Objects enable WebSocket hibernation to reduce memory overhead. Store connection state in SQL or KV, configure hibernation in wrangler, and use alarm-based resumption patterns. This is ideal for chat rooms, multiplayer servers, and long-lived connections requiring per-client or per-room state.

Configure migrations in wrangler to version your DO schema safely. Use alarms for scheduled tasks, rate limiting, and state coordination. Define alarm handlers within your DO class, schedule them with stable routing, and combine with RPC methods to prevent common configuration errors and maintain consistency.

Durable Objects support both SQL and KV storage for persistence. Choose SQL for structured queries and relational data; use KV for simple key-value pairs. Combine with DO in-memory state for fast, low-latency coordination while offloading durability to your preferred backend.

Ensure DO classes are exported correctly, bindings are wired in wrangler.toml, migrations are idempotent, and WebSocket hibernation is enabled if needed. Use stable routing for RPC calls, handle alarms with proper error handling, and test migrations before production deployment.

Durable Objects excel at per-user sessions, chat rooms, multiplayer game servers, rate limiting, and session management. They solve stateful coordination problems where you need unique, persistent object identity, fast RPC-style communication, and optional WebSocket support with hibernation.