Read, write, delete, and list objects in a Cloudflare R2 bucket from a Worker using the native bucket binding, including HTTP and custom metadata.

Documented steps

1. Add an R2 bucket binding to your Worker config. In wrangler.jsonc: {"r2_buckets": [{"binding": "MY_BUCKET", "bucket_name": "<YOUR_BUCKET_NAME>"}]} (or in wrangler.toml: [[r2_buckets]] / binding = "MY_BUCKET" / bucket_name = "<YOUR_BUCKET_NAME>"). See https://developers.cloudflare.com/r2/api/workers/workers-api-reference/
2. In your Worker's fetch handler, derive the object key from the request (e.g. `const key = new URL(request.url).pathname.slice(1);`).
3. Write an object with `await env.MY_BUCKET.put(key, request.body, { httpMetadata: request.headers, customMetadata: { uploadedBy: 'agent' } })` — put() returns an R2Object on success or null if an onlyIf precondition fails.
4. Read an object with `const obj = await env.MY_BUCKET.get(key)`; if obj is null, return 404. Stream the body back with `new Response(obj.body, { headers })` and call `obj.writeHttpMetadata(headers); headers.set('etag', obj.httpEtag);` before constructing the Response.
5. Get metadata only (no body) with `const obj = await env.MY_BUCKET.head(key)` — returns R2Object or null; cheaper than get() when you just need existence/metadata.
6. Delete one or more objects with `await env.MY_BUCKET.delete(key)` or `await env.MY_BUCKET.delete([key1, key2, ...])`; delete is void and strongly consistent, and accepts up to 1000 keys per call.
7. List objects with `const listed = await env.MY_BUCKET.list({ prefix: 'images/', limit: 500, include: ['httpMetadata', 'customMetadata'] })`; iterate `listed.objects`.
8. Paginate correctly: check `listed.truncated` (not `objects.length < limit`) and pass `listed.cursor` back into the next `list({ ...options, cursor })` call until `truncated` is false.
9. Ensure your Wrangler compatibility_date is 2022-08-04 or later (or set the r2_list_honor_include compatibility flag) so that the `include` option on list() is honored as specified instead of defaulting to including both metadata types.