Cache
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Das Cache
-Interface bietet einen persistenten Speichermechanismus für Request
/ Response
-Objektpaare, die im langlebigen Speicher zwischengespeichert sind. Wie lange ein Cache
-Objekt lebt, hängt vom Browser ab, aber Skripte eines einzigen Ursprungs können sich in der Regel auf das Vorhandensein eines zuvor gefüllten Cache
-Objekts verlassen. Beachten Sie, dass das Cache
-Interface sowohl für fensterartige als auch für Worker-Umgebungen freigegeben ist. Sie müssen es nicht in Verbindung mit Service Workern verwenden, obwohl es in der Service-Worker-Spezifikation definiert ist.
Ein Ursprung kann mehrere, benannte Cache
-Objekte haben. Sie sind dafür verantwortlich, wie Ihr Skript (z. B. in einem ServiceWorker
) Cache
-Aktualisierungen handhabt. Einträge in einem Cache
werden nicht aktualisiert, es sei denn, es wird ausdrücklich verlangt; sie laufen nicht ab, es sei denn, sie werden gelöscht. Verwenden Sie CacheStorage.open()
, um ein spezifisches benanntes Cache
-Objekt zu öffnen, und dann rufen Sie eine der Cache
-Methoden auf, um den Cache
zu warten.
Sie sind auch dafür verantwortlich, Cache-Einträge regelmäßig zu löschen. Jeder Browser hat ein hartes Limit für die Menge des Cache-Speichers, den ein gegebener Ursprung nutzen kann. Schätzungen der Cache
-Quota-Nutzung sind über die Methode StorageManager.estimate()
verfügbar. Der Browser bemüht sich, den Speicherplatz zu verwalten, kann jedoch den Cache
-Speicher für einen Ursprung löschen. Der Browser wird im Allgemeinen entweder alle oder keine der Daten für einen Ursprung löschen. Stellen Sie sicher, dass Sie Caches nach Namen versionieren und die Caches nur mit der Version des Skripts verwenden, mit der sie sicher funktionieren können. Weitere Informationen finden Sie unter Löschen alter Caches.
Hinweis:
Der Schlüsselabgleichsalgorithmus hängt vom VARY-Header im Wert ab. Um einen neuen Schlüssel abzugleichen, muss sowohl der Schlüssel als auch der Wert für Einträge im Cache
-Objekt betrachtet werden.
Hinweis: Das Cache-API beachtet die HTTP-Caching-Header nicht.
Instanzmethoden
Cache.match()
-
Gibt ein
Promise
zurück, das mit der Antwort auf die erste übereinstimmende Anfrage imCache
-Objekt aufgelöst wird. Cache.matchAll()
-
Gibt ein
Promise
zurück, das mit einem Array aller übereinstimmenden Antworten imCache
-Objekt aufgelöst wird. Cache.add()
-
Nimmt eine URL, ruft sie ab und fügt das resultierende Antwortobjekt dem angegebenen Cache hinzu. Dies entspricht funktional dem Aufruf von
fetch()
, gefolgt vonput()
, um die Ergebnisse dem Cache hinzuzufügen. Cache.addAll()
-
Nimmt ein Array von URLs, ruft sie ab und fügt die resultierenden Antwortobjekte dem angegebenen Cache hinzu.
Cache.put()
-
Nimmt sowohl eine Anfrage als auch deren Antwort und fügt sie dem angegebenen Cache hinzu.
Cache.delete()
-
Findet den
Cache
-Eintrag, dessen Schlüssel die Anfrage ist, und gibt einPromise
zurück, das zutrue
aufgelöst wird, wenn ein übereinstimmenderCache
-Eintrag gefunden und gelöscht wird. Wenn keinCache
-Eintrag gefunden wird, wird das Promise zufalse
aufgelöst. Cache.keys()
-
Gibt ein
Promise
zurück, das mit einem Array vonCache
-Schlüsseln aufgelöst wird.
Beispiele
Dieser Code-Ausschnitt stammt aus dem ausgewählten Service-Worker-Caching-Beispiel. (siehe selektives Caching live) Der Code verwendet CacheStorage.open()
, um alle Cache
-Objekte mit einem Content-Type
-Header zu öffnen, der mit font/
beginnt.
Der Code verwendet dann Cache.match()
, um zu prüfen, ob bereits eine passende Schriftart im Cache vorhanden ist, und wenn ja, gibt er diese zurück. Wenn keine passende Schriftart vorhanden ist, ruft der Code die Schriftart aus dem Netzwerk ab und verwendet Cache.put()
, um die abgerufene Ressource im Cache zu speichern.
Der Code behandelt Ausnahmen, die von der fetch()
-Operation ausgelöst werden. Beachten Sie, dass eine HTTP-Fehlerantwort (z.B. 404) keine Ausnahme auslöst. Es wird ein normales Antwortobjekt zurückgegeben, das den entsprechenden Fehlercode enthält.
Der Code-Ausschnitt zeigt auch eine bewährte Vorgehensweise für die Versionierung von Caches, die vom Service Worker verwendet werden. Obwohl es in diesem Beispiel nur einen Cache gibt, kann derselbe Ansatz für mehrere Caches verwendet werden. Es wird ein Kurzbezeichner für einen Cache auf einen bestimmten, versionierten Cachename abgebildet. Der Code löscht auch alle Caches, die nicht in CURRENT_CACHES
benannt sind.
Im Codebeispiel ist caches
eine Eigenschaft der ServiceWorkerGlobalScope
. Es enthält das CacheStorage
-Objekt, über das das CacheStorage
-Interface zugänglich ist.
Hinweis:
In Chrome können Sie unter chrome://inspect/#service-workers
auf den Link "inspect" unter dem registrierten Service Worker klicken, um Protokollaussagen für die verschiedenen Aktionen des service-worker.js
-Skripts anzuzeigen.
const CACHE_VERSION = 1;
const CURRENT_CACHES = {
font: `font-cache-v${CACHE_VERSION}`,
};
self.addEventListener("activate", (event) => {
// Delete all caches that aren't named in CURRENT_CACHES.
// While there is only one cache in this example, the same logic
// will handle the case where there are multiple versioned caches.
const expectedCacheNamesSet = new Set(Object.values(CURRENT_CACHES));
event.waitUntil(
caches.keys().then((cacheNames) =>
Promise.all(
cacheNames.map((cacheName) => {
if (!expectedCacheNamesSet.has(cacheName)) {
// If this cache name isn't present in the set of
// "expected" cache names, then delete it.
console.log("Deleting out of date cache:", cacheName);
return caches.delete(cacheName);
}
}),
),
),
);
});
self.addEventListener("fetch", (event) => {
console.log("Handling fetch event for", event.request.url);
event.respondWith(
caches.open(CURRENT_CACHES.font).then((cache) => {
return cache
.match(event.request)
.then((response) => {
if (response) {
// If there is an entry in the cache for event.request,
// then response will be defined and we can just return it.
// Note that in this example, only font resources are cached.
console.log(" Found response in cache:", response);
return response;
}
// Otherwise, if there is no entry in the cache for event.request,
// response will be undefined, and we need to fetch() the resource.
console.log(
" No response for %s found in cache. About to fetch " +
"from network…",
event.request.url,
);
// We call .clone() on the request since we might use it
// in a call to cache.put() later on.
// Both fetch() and cache.put() "consume" the request,
// so we need to make a copy.
// (see https://developer.mozilla.org/en-US/docs/Web/API/Request/clone)
return fetch(event.request.clone()).then((response) => {
console.log(
" Response for %s from network is: %O",
event.request.url,
response,
);
if (
response.status < 400 &&
response.headers.has("content-type") &&
response.headers.get("content-type").match(/^font\//i)
) {
// This avoids caching responses that we know are errors
// (i.e. HTTP status code of 4xx or 5xx).
// We also only want to cache responses that correspond
// to fonts, i.e. have a Content-Type response header that
// starts with "font/".
// Note that for opaque filtered responses
// https://fetch.spec.whatwg.org/#concept-filtered-response-opaque
// we can't access to the response headers, so this check will
// always fail and the font won't be cached.
// All of the Google Web Fonts are served from a domain that
// supports CORS, so that isn't an issue here.
// It is something to keep in mind if you're attempting
// to cache other resources from a cross-origin
// domain that doesn't support CORS, though!
console.log(" Caching the response to", event.request.url);
// We call .clone() on the response to save a copy of it
// to the cache. By doing so, we get to keep the original
// response object which we will return back to the controlled
// page.
// https://developer.mozilla.org/en-US/docs/Web/API/Request/clone
cache.put(event.request, response.clone());
} else {
console.log(" Not caching the response to", event.request.url);
}
// Return the original response object, which will be used to
// fulfill the resource request.
return response;
});
})
.catch((error) => {
// This catch() will handle exceptions that arise from the match()
// or fetch() operations.
// Note that a HTTP error response (e.g. 404) will NOT trigger
// an exception.
// It will return a normal response object that has the appropriate
// error code set.
console.error(" Error in fetch handler:", error);
throw error;
});
}),
);
});
Cookies und Cache-Objekte
Das Fetch API erfordert, dass Set-Cookie
-Header entfernt werden, bevor ein Response
-Objekt von fetch()
zurückgegeben wird. Daher enthält eine Response
, die in einem Cache
gespeichert ist, keine Set-Cookie
-Header und verursacht somit nicht, dass Cookies gespeichert werden.
Spezifikationen
Specification |
---|
Service Workers # cache-interface |
Browser-Kompatibilität
BCD tables only load in the browser