Skip to content

Commit b5557e7

Browse files
authored
Add changelog entry for cache: no-store (#19037)
* Add changelog entry for cache: no-store Backdates this changelog entry for https://developers.cloudflare.com/changelog-next/ * Fix title
1 parent 2d43f88 commit b5557e7

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: Bypass caching for subrequests made from Cloudflare Workers, with Request.cache
3+
description: New runtime APIs allow you to control when subrequests are cached, increasing compatibility with popular NPM packages
4+
products:
5+
- workers
6+
date: 2024-11-11T14:00:00Z
7+
---
8+
9+
import { Render, PackageManagers, TypeScriptExample } from "~/components"
10+
11+
You can now use the [`cache`](/workers/runtime-apis/request/#options) property of the [`Request`](/workers/runtime-apis/request/) interface to bypass [Cloudflare's cache](/workers/reference/how-the-cache-works/) when making subrequests from [Cloudflare Workers](/workers), by setting its value to `no-store`.
12+
13+
<TypeScriptExample filename="index.ts">
14+
```ts
15+
export default {
16+
async fetch(req, env, ctx): Promise<Response> {
17+
const request = new Request("https://cloudflare.com", { cache: 'no-store'});
18+
const response = await fetch(request);
19+
return response;
20+
}
21+
} satisfies ExportedHandler<Environment>
22+
```
23+
</TypeScriptExample>
24+
25+
When you set the value to `no-store` on a subrequest made from a Worker, the Cloudflare Workers runtime will not check whether a match exists in the cache, and not add the response to the cache, even if the response includes directives in the `Cache-Control` HTTP header that otherwise indicate that the response is cacheable.
26+
27+
This increases compatibility with NPM packages and JavaScript frameworks that rely on setting the [`cache`](/workers/runtime-apis/request/#options) property, which is a cross-platform standard part of the [`Request`](/workers/runtime-apis/request/) interface. Previously, if you set the `cache` property on `Request`, the Workers runtime threw an exception.
28+
29+
If you've tried to use `@planetscale/database`, `redis-js`, `stytch-node`, `supabase`, `axiom-js` or have seen the error message `The cache field on RequestInitializerDict is not implemented in fetch` — you should try again, making sure that the [Compatibility Date](/workers/configuration/compatibility-dates/) of your Worker is set to on or after `2024-11-11`, or the [`cache_option_enabled` compatibility flag](/workers/configuration/compatibility-flags/#enable-cache-no-store-http-standard-api) is enabled for your Worker.
30+
31+
* Learn [how the Cache works with Cloudflare Workers](/workers/reference/how-the-cache-works/)
32+
* Enable [Node.js compatibility](/workers/runtime-apis/nodejs/) for your Cloudflare Worker
33+
* Explore [Runtime APIs](/workers/runtime-apis/) and [Bindings](/workers/runtime-apis/bindings/) available in Cloudflare Workers

0 commit comments

Comments
 (0)