infochanged

Workers - Workers Cache — mark cached responses stale with invalidate()

Announced: 2026-09-29
Tags: Workers
Severity: info, set by reef/rss-rule-v1
Source: https://developers.cloudflare.com/changelog/post/2026-09-29-workers-cache-invalidate/

<a href="https://developers.cloudflare.com/workers/cache/">Workers Cache</a> now supports <code>invalidate()</code>, the soft counterpart of <code>purge()</code>. <code>purge()</code> deletes matching cached responses, so the next request is a cache miss. <code>invalidate()</code> keeps them but marks them stale, so the cache revalidates them with your Worker instead. To revalidate a response, the cache sends your Worker a conditional request built from the validators stored with it — for example, <code>If-None-Match</code> carrying the cached <code>ETag</code>. If your Worker answers <code>304 Not Modified</code>, the cache keeps the stored body. If your Worker answers with a full <code>200</code> response, that response replaces the cached one. <code>invalidate()</code> accepts the same options as <code>purge()</code>: <code>tags</code>, <code>pathPrefixes</code>, or <code>purgeEverything</code>. It follows the same per-entrypoint scoping and resolves to the same result object. Call it as <code>ctx.cache.invalidate()</code>, or import <code>cache</code> from <code>cloudflare:workers</code> and call <code>cache.invalidate()</code>. Use <code>invalidate()</code> when one call covers many cached responses but only some of them changed. Your Worker needs to emit <code>ETag</code> or <code>Last-Modified</code> and answer matching conditional requests with <code>304</code>. Each unchanged response then costs a validator check instead of a full regeneration: <div><div data-nb-tabs data-nb-sync-key="workersExamples" class><div class="relative flex border-b border-border" role="tablist" data-nb-tabs-list></div><div class="mt-3"><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="JavaScript" class><figure class="nb-code-figure nb-code-figure-titled" data-nb-lang="js"><figcaption class="nb-code-title">src/index.jsjs</figcaption><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="js" data-nb-lang="js"><code>export default { async fetch(request, env, ctx) { if (request.method === "POST") { // Write the updated catalog, then mark every cached product page stale. await syncCatalog(env, await request.json()); await ctx.cache.invalidate({ tags: ["products"] }); return new Response("Synced"); } const product = await getProduct(env, request); const etag = "${product.revision}"; const headers = { "Cache-Control": "public, max-age=86400", "Cache-Tag": "products", ETag: etag, }; // The product has not changed since it was cached. Answer 304, and the // cache keeps the body it already has. if (request.headers.get("If-None-Match") === etag) { return new Response(null, { status: 304, headers }); } return new Response(renderProductPage(product), { headers }); }, };</code></pre></figure></div><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="TypeScript" class><figure class="nb-code-figure nb-code-figure-titled" data-nb-lang="ts"><figcaption class="nb-code-title">src/index.tsts</figcaption><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="ts" data-nb-lang="ts"><code>export default { async fetch(request, env, ctx): Promise<Response> { if (request.method === "POST") { // Write the updated catalog, then mark every cached product page stale. await syncCatalog(env, await request.json()); await ctx.cache.invalidate({ tags: ["products"] }); return new Response("Synced"); } const product = await getProduct(env, request); const etag = "${product.revision}"; const headers = { "Cache-Control": "public, max-age=86400", "Cache-Tag": "products", ETag: etag, }; // The product has not changed since it was cached. Answer 304, and the // cache keeps the body it already has. if (request.headers.get("If-None-Match") === etag) { return new Response(null, { status: 304, headers }); } return new Response(renderProductPage(product), { headers }); }, } satisfies ExportedHandler<Env>;</code></pre></figure></div></div></div><script type="module" src="https://developers.cloudflare.com/home/runner/work/cloudflare-docs/cloudflare-docs/src/components/ui/tabs/Tabs.astro?astro&type=script&index=0&lang.ts"></script></div> For more information, refer to <a href="https://developers.cloudflare.com/workers/cache/purge/#invalidate-cached-responses">Invalidate cached responses</a>.

The text above is the source's. reef added the severity, the dates it could read from the text, and the endpoints and scopes named in code.