---
title: Using the Cache API · Cloudflare Workers docs
description: Use the Cache API to store responses in Cloudflare's cache.
lastUpdated: 2025-04-28T14:11:18.000Z
source_url:
  html: https://77261bbd.preview.developers.cloudflare.com/workers/examples/cache-api/index.md
  md: https://77261bbd.preview.developers.cloudflare.com/workers/examples/cache-api/
---

If you want to get started quickly, click on the button below.

[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/cloudflare/docs-examples/tree/main/workers/cache-api)

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

* JavaScript

  ```js
  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-max-age 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;
    },
  };
  ```

* TypeScript

  ```ts
  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-max-age 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>;
  ```

* Python

  ```py
  from pyodide.ffi import create_proxy
  from js import Response, Request, URL, caches, fetch


  async def on_fetch(request, _env, ctx):
      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")
          ctx.waitUntil(create_proxy(cache.put(cache_key, response.clone())))
      else:
          print(f"Cache hit for: {request.url}.")
      return response
  ```

* Hono

  ```ts
  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;
  ```
