Using the Cache API
- On this page

Using the Cache API

Use the Cache API to store responses in Cloudflare's cache.

Last updated Apr 23, 2026 If you want to get started quickly, click on the button below.

This creates a repository in your GitHub account and deploys the application to Cloudflare Workers.

export default {
    async fetch(request, env, ctx) {
        const cacheUrl = new URL(request.url);

        // Construct the cache key from the cache URL
        const cacheKey = new Request(cacheUrl.toString(), request);
        const cache = caches.default;

        // Check whether the value is already available in the cache
        // if not, you will need to fetch it from origin, and store it in the cache
        let response = await cache.match(cacheKey);

        if (!response) {
            console.log(
                `Response for request url: ${request.url} not present in cache. Fetching and caching request.`,
            );
            // If not in cache, get it from origin
            response = await fetch(request);

            // Must use Response constructor to inherit all of response's fields
            response = new Response(response.body, response);

            // Cache API respects Cache-Control headers. Setting s-maxage to 10
            // will limit the response to be in cache for 10 seconds max

            // Any changes made to the response here will be reflected in the cached value
            response.headers.append("Cache-Control", "s-maxage=10");

            ctx.waitUntil(cache.put(cacheKey, response.clone()));
        } else {
            console.log(`Cache hit for: ${request.url}.`);
        }
        return response;
    },
};

interface Env {}
export default {
    async fetch(request, env, ctx): Promise<Response> {
        const cacheUrl = new URL(request.url);

        // Construct the cache key from the cache URL
        const cacheKey = new Request(cacheUrl.toString(), request);
        const cache = caches.default;

        // Check whether the value is already available in the cache
        // if not, you will need to fetch it from origin, and store it in the cache
        let response = await cache.match(cacheKey);

        if (!response) {
            console.log(
                `Response for request url: ${request.url} not present in cache. Fetching and caching request.`,
            );
            // If not in cache, get it from origin
            response = await fetch(request);

            // Must use Response constructor to inherit all of response's fields
            response = new Response(response.body, response);

            // Cache API respects Cache-Control headers. Setting s-maxage to 10
            // will limit the response to be in cache for 10 seconds max

            // Any changes made to the response here will be reflected in the cached value
            response.headers.append("Cache-Control", "s-maxage=10");

            ctx.waitUntil(cache.put(cacheKey, response.clone()));
        } else {
            console.log(`Cache hit for: ${request.url}.`);
        }
        return response;
    },
} satisfies ExportedHandler<Env>;

from workers import WorkerEntrypoint
from pyodide.ffi import create_proxy
from js import Response, Request, URL, caches, fetch

class Default(WorkerEntrypoint):
    async def fetch(self, request):
        cache_url = request.url

        # Construct the cache key from the cache URL
        cache_key = Request.new(cache_url, request)
        cache = caches.default

        # Check whether the value is already available in the cache
        # if not, you will need to fetch it from origin, and store it in the cache
        response = await cache.match(cache_key)

        if response is None:
            print(f"Response for request url: {request.url} not present in cache. Fetching and caching request.")
            # If not in cache, get it from origin
            response = await fetch(request)
            # Must use Response constructor to inherit all of response's fields
            response = Response.new(response.body, response)

            # Cache API respects Cache-Control headers. Setting s-max-age to 10
            # will limit the response to be in cache for 10 seconds s-maxage
            # Any changes made to the response here will be reflected in the cached value
            response.headers.append("Cache-Control", "s-maxage=10")
            self.ctx.waitUntil(create_proxy(cache.put(cache_key, response.clone())))
        else:
            print(f"Cache hit for: {request.url}.")
        return response

import { Hono } from "hono";
import { cache } from "hono/cache";

const app = new Hono();

// We leverage hono built-in cache helper here
app.get(
    "*",
    cache({
        cacheName: "my-cache",
        cacheControl: "max-age=3600", // 1 hour
    }),
);

// Add a route to handle the request if it's not in cache
app.get("*", (c) => {
    return c.text("Hello from Hono!");
});

export default app;

Was this helpful?

YesNo

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/examples/cache-api/#page","headline":"Using the Cache API","description":"Use the Cache API to store responses in Cloudflare's cache.","url":"https://developers.cloudflare.com/workers/examples/cache-api/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/examples/cache-api/og.png?v=1377464805d9f59c","dateModified":"2026-04-23","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"},"keywords":["Middleware","Caching","JavaScript","TypeScript","Python"]}

description: Cache POST requests using the Cache API. title: Cache POST requests image: https://developers.cloudflare.com/workers/examples/cache-post-request/og.png?v=2a45a6436c0a279f

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt
Use this file to discover all available pages before exploring further.

Using the Cache API

Using the Cache API

On this page