Edge Computing with Cloudflare Workers & Deno · Lesson

Caching Strategies

Implement effective caching mechanisms using Cloudflare's CDN and Workers Cache API to reduce latency.

Caching Strategies is a free Edge Computing with Cloudflare Workers & Deno lesson on CoddyKit — lesson 1 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Edge Computing with Cloudflare Workers & Deno learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

What is Caching?

Imagine you need to grab a book. If it's on your desk, it's super fast! If it's at the local library, it's still quick. But if you have to order it from a distant warehouse, it takes much longer.

Caching works similarly. It's the process of storing copies of frequently accessed data closer to where it's needed, speeding up future requests.

Why Cache at the Edge?

In edge computing, 'closer' means at the edge of the network, near your users. Caching at the edge offers several key benefits:

Reduced Latency: Content reaches users faster.
Reduced Origin Load: Your main servers handle fewer requests.
Improved User Experience: Websites and applications feel snappier.

Cloudflare CDN Caching

Cloudflare's Content Delivery Network (CDN) is your first line of defense for caching. It automatically stores static assets (like images, CSS files, and JavaScript bundles) at its global network of edge locations.

When a user requests one of these assets, Cloudflare serves it from the nearest edge server, not your origin server.

HTTP Cache-Control Headers

You can tell CDNs and browsers how to cache your content using HTTP Cache-Control headers. These headers are sent with your server's response.

max-age=X: Resource is fresh for X seconds.
s-maxage=Y: Specifically for shared caches (CDNs), overrides max-age.
no-cache: Must revalidate with origin before serving cached content.
no-store: Never cache this content.

Workers Cache API Intro

While Cloudflare's CDN handles static assets, what about dynamic content or API responses? That's where the Cloudflare Workers Cache API comes in.

This powerful API allows your Worker to programmatically store and retrieve any HTTP Response object in Cloudflare's global cache, giving you fine-grained control.

Basic Cache API Flow

The Workers Cache API uses a simple key-value pattern:

Key: An HTTP Request object (or a URL string).
Value: An HTTP Response object.

You use cache.put(request, response) to store and cache.match(request) to retrieve.

Storing with cache.put()

Let's write a Worker that fetches a resource from an origin and then stores a copy of its response in the cache using cache.put(). This makes it available for future requests.

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event));
});

async function handleRequest(event) {
  const request = event.request;
  const cacheKey = new Request(request.url, request); // Key for cache
  const cache = caches.default; // Get default cache storage

  // Fetch from the origin server
  const response = await fetch(request);

  // Store a clone of the response in cache
  // event.waitUntil ensures caching happens in background
  event.waitUntil(cache.put(cacheKey, response.clone()));

  return response; // Return the original response
}

Retrieving with cache.match()

Now, let's modify the Worker to first check if the requested resource is in the cache using cache.match(). If found, we return the cached version immediately. Otherwise, we fetch from the origin and then cache it.

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event));
});

async function handleRequest(event) {
  const request = event.request;
  const cacheKey = new Request(request.url, request);
  const cache = caches.default;

  // Try to find the response in cache
  let response = await cache.match(cacheKey);

  if (response) {
    // Cache hit! Return cached response
    return response;
  }

  // Cache miss. Fetch from origin
  response = await fetch(request);

  // Store the new response in cache for next time
  event.waitUntil(cache.put(cacheKey, response.clone()));

  return response;
}

Cache Invalidation & Best Practices

Effective caching requires managing stale data. Here are some tips:

Purging: Use the Cloudflare dashboard or API to invalidate specific URLs.
Vary Header: Use the Vary HTTP header (e.g., Vary: Accept-Encoding) to cache different versions based on request headers.
Time-based Expiry: Set appropriate Cache-Control headers or options in cache.put() to automatically expire cached items.

Test Your Knowledge

The Cloudflare Workers Cache API allows you to programmatically control caching. Which method is used to store a response in the cache?

Recap: Caching Strategies

In this lesson, we explored powerful caching strategies to optimize performance at the edge:

Cloudflare's CDN automatically caches static assets.
HTTP Cache-Control headers allow you to define caching behavior.
The Workers Cache API provides programmatic control for caching dynamic content.
Proper cache invalidation and management are crucial for fresh data.

Mastering caching is key to building fast, efficient edge applications!

Frequently asked questions

Is the “Caching Strategies” lesson free?

Yes — the full text of “Caching Strategies” is free to read here on the web, and the Edge Computing with Cloudflare Workers & Deno course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Edge Computing with Cloudflare Workers & Deno course, upgrade to CoddyKit PRO.

What will I learn in “Caching Strategies”?

Implement effective caching mechanisms using Cloudflare's CDN and Workers Cache API to reduce latency. You practise Edge Computing with Cloudflare Workers & Deno with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Edge Computing with Cloudflare Workers & Deno?

No prior experience is required. Edge Computing with Cloudflare Workers & Deno on CoddyKit is structured for beginners through advanced learners; this is — lesson 1 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Caching Strategies” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Edge Computing with Cloudflare Workers & Deno lesson?

Yes. Every Edge Computing with Cloudflare Workers & Deno lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

← Back to Edge Computing with Cloudflare Workers & Deno