Skip to content

Namespace

Source: src/Cloudflare/KV/Namespace.ts

A Cloudflare Workers KV namespace for key-value storage at the edge.

KV provides eventually-consistent, low-latency reads with global replication. Create a namespace as a resource, then bind it to a Worker to get/put values at runtime.

const kv = yield* Cloudflare.KV.Namespace("MyKV");
const kv = yield* Cloudflare.KV.ReadWriteNamespace(MyKV);
// Read a value
const value = yield* kv.get("my-key");
// Write a value
yield* kv.put("my-key", "hello world");

Provide Cloudflare.KV.ReadWriteNamespaceBinding (native Worker binding) or Cloudflare.KV.ReadWriteNamespaceHttp (scoped HTTP token) in the worker’s runtime layer. Use Cloudflare.KV.ReadNamespace / Cloudflare.KV.WriteNamespace for least-privilege read- or write-only access.