← Cloudflare Workers / workers / testing / miniflare / storage

Cache

Referenční informace o Cache
Jak funguje mezipaměť (všimněte si, že mezipaměť využívající fetch není podporováno)

Výchozí mezipaměť

Přístup k výchozí cache je ve výchozím nastavení povolen:

addEventListener("fetch", (e) => {
	e.respondWith(caches.default.match("http://miniflare.dev"));
});

Pojmenované cache

K cache s vlastním jmenným prostorem můžete přistupovat pomocí open. Vezměte na vědomí, že nemůžete pojmenovat svou cache default, pokus o to vyvolá chybu:

await caches.open("cache_name");

Perzistence

Ve výchozím nastavení jsou data v mezipaměti uložena v paměti. Zůstávají zachována mezi znovunačteními, ale ne mezi různými Miniflare instance. Chcete-li povolit perzistenci do souborového systému, zadejte možnost perzistence mezipaměti:

const mf = new Miniflare({
	cachePersist: true, // Defaults to ./.mf/cache
	cachePersist: "./data", // Custom path
});

Manipulace mimo Workers

Pro účely testování může být užitečné ukládat/porovnávat data v cache mimo Worker. Můžete to provést pomocí getCaches metoda:

import { Miniflare, Response } from "miniflare";

const mf = new Miniflare({
	modules: true,
	script: `
  export default {
    async fetch(request) {
      const url = new URL(request.url);
      const cache = caches.default;
      if(url.pathname === "/put") {
        await cache.put("https://miniflare.dev/", new Response("1", {
          headers: { "Cache-Control": "max-age=3600" },
        }));
      }
      return cache.match("https://miniflare.dev/");
    }
  }
  `,
});
let res = await mf.dispatchFetch("http://localhost:8787/put");
console.log(await res.text()); // 1

const caches = await mf.getCaches(); // Gets the global caches object
const cachedRes = await caches.default.match("https://miniflare.dev/");
console.log(await cachedRes.text()); // 1

await caches.default.put(
	"https://miniflare.dev",
	new Response("2", {
		headers: { "Cache-Control": "max-age=3600" },
	}),
);
res = await mf.dispatchFetch("http://localhost:8787");
console.log(await res.text()); // 2

Vymazávání

Všechny položky z mezipaměti můžete programově vymazat pomocí purgeCache metodu na Miniflare instance. To se hodí při vývoji, kdy potřebujete vymazat uložené assety bez restartování instance:

const mf = new Miniflare({ /* options */ });

// Purge the default cache and get the number of entries purged
const count = await mf.purgeCache();
console.log(`Purged ${count} entries`);

// Purge a specific named cache
await mf.purgeCache("my-named-cache");

Zakázání

Výchozí i pojmenované cache lze deaktivovat pomocí disableCache možnost. Po vypnutí budou mezipaměti v sandboxu stále dostupné, jen nebudou nic ukládat. To může být užitečné během vývoje:

const mf = new Miniflare({
	cache: false,
});