---
title: Cache Tags using Workers
description: Send Additional Cache Tags using Workers
image: https://edgetunnel-b2h.pages.dev/dev-products-preview.png
---

> Documentation Index  
> Fetch the complete documentation index at: https://edgetunnel-b2h.pages.dev/workers/llms.txt  
> Use this file to discover all available pages before exploring further. 

[Skip to content](#%5Ftop) 

# Cache Tags using Workers

Send Additional Cache Tags using Workers

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-tags)

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

* [  JavaScript ](#tab-panel-12479)
* [  TypeScript ](#tab-panel-12480)
* [  Hono ](#tab-panel-12481)
* [  Python ](#tab-panel-12482)

**JavaScript**

```js
export default {
  async fetch(request) {
    const requestUrl = new URL(request.url);
    const params = requestUrl.searchParams;
    const tags =
      params && params.has("tags") ? params.get("tags").split(",") : [];
    const url = params && params.has("uri") ? params.get("uri") : "";
    if (!url) {
      const errorObject = {
        error: "URL cannot be empty",
      };
      return new Response(JSON.stringify(errorObject), { status: 400 });
    }
    const init = {
      cf: {
        cacheTags: tags,
      },
    };
    return fetch(url, init)
      .then((result) => {
        const cacheStatus = result.headers.get("cf-cache-status");
        const lastModified = result.headers.get("last-modified");
        const response = {
          cache: cacheStatus,
          lastModified: lastModified,
        };
        return new Response(JSON.stringify(response), {
          status: result.status,
        });
      })
      .catch((err) => {
        const errorObject = {
          error: err.message,
        };
        return new Response(JSON.stringify(errorObject), { status: 500 });
      });
  },
};
```

**TypeScript**

```ts
export default {
  async fetch(request): Promise<Response> {
    const requestUrl = new URL(request.url);
    const params = requestUrl.searchParams;
    const tags =
      params && params.has("tags") ? params.get("tags").split(",") : [];
    const url = params && params.has("uri") ? params.get("uri") : "";
    if (!url) {
      const errorObject = {
        error: "URL cannot be empty",
      };
      return new Response(JSON.stringify(errorObject), { status: 400 });
    }
    const init = {
      cf: {
        cacheTags: tags,
      },
    };
    return fetch(url, init)
      .then((result) => {
        const cacheStatus = result.headers.get("cf-cache-status");
        const lastModified = result.headers.get("last-modified");
        const response = {
          cache: cacheStatus,
          lastModified: lastModified,
        };
        return new Response(JSON.stringify(response), {
          status: result.status,
        });
      })
      .catch((err) => {
        const errorObject = {
          error: err.message,
        };
        return new Response(JSON.stringify(errorObject), { status: 500 });
      });
  },
} satisfies ExportedHandler;
```

**TypeScript**

```ts
import { Hono } from "hono";


const app = new Hono();


app.all("*", async (c) => {
  const tags = c.req.query("tags") ? c.req.query("tags").split(",") : [];
  const uri = c.req.query("uri") ? c.req.query("uri") : "";


  if (!uri) {
    return c.json({ error: "URL cannot be empty" }, 400);
  }


  const init = {
    cf: {
      cacheTags: tags,
    },
  };


  const result = await fetch(uri, init);
  const cacheStatus = result.headers.get("cf-cache-status");
  const lastModified = result.headers.get("last-modified");


  const response = {
    cache: cacheStatus,
    lastModified: lastModified,
  };


  return c.json(response, result.status);
});


app.onError((err, c) => {
  return c.json({ error: err.message }, 500);
});


export default app;
```

**Python**

```py
from workers import WorkerEntrypoint, Response, fetch
from js import URL


class Default(WorkerEntrypoint):
    async def fetch(self, request):
        request_url = URL.new(request.url)
        params = request_url.searchParams
        tags = params["tags"].split(",") if "tags" in params else []
        url = params["uri"] or None


        if url is None:
            return Response.json({"error": "URL cannot be empty"}, status=400)


        result = await fetch(url, cf={"cacheTags": tags})


        cache_status = result.headers["cf-cache-status"]
        last_modified = result.headers["last-modified"]


        return Response.json({"cache": cache_status, "lastModified": last_modified}, status=result.status)
```

```json
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://edgetunnel-b2h.pages.dev/workers/examples/cache-tags/#page","headline":"Cache Tags using Workers · Cloudflare Workers docs","description":"Send Additional Cache Tags using Workers","url":"https://edgetunnel-b2h.pages.dev/workers/examples/cache-tags/","inLanguage":"en","image":"https://edgetunnel-b2h.pages.dev/dev-products-preview.png","dateModified":"2026-07-06","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://edgetunnel-b2h.pages.dev/#website","name":"Cloudflare Docs","url":"https://edgetunnel-b2h.pages.dev/"},"keywords":["Caching","JavaScript","TypeScript","Python"]}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/workers/","name":"Workers"}},{"@type":"ListItem","position":3,"item":{"@id":"/workers/examples/","name":"Examples"}},{"@type":"ListItem","position":4,"item":{"@id":"/workers/examples/cache-tags/","name":"Cache Tags using Workers"}}]}
```
