Cache: addAll()-Methode
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: Dieses Feature ist verfügbar in Web Workers.
Die addAll()
-Methode der Cache
-Schnittstelle nimmt ein Array von URLs, ruft diese ab und fügt die resultierenden Antwortobjekte zum angegebenen Cache hinzu. Die während des Abrufs erstellten Anfrageobjekte werden zu Schlüsseln für die gespeicherten Antwortoperationen.
Note:
addAll()
überschreibt alle Schlüssel/Wert-Paare, die zuvor im Cache gespeichert wurden und mit der Anfrage übereinstimmen, schlägt jedoch fehl, wenn eine resultierendeput()
-Operation einen vorherigen Cache-Eintrag überschreiben würde, der von derselbenaddAll()
-Methode gespeichert wurde.
Syntax
addAll(requests)
Parameter
requests
-
Ein Array von Anfragen für die Ressourcen, die Sie dem Cache hinzufügen möchten. Diese können
Request
-Objekte oder URLs sein.Diese Anfragen werden als Parameter für den
Request()
-Konstruktor verwendet, sodass URLs den gleichen Regeln wie für diesen Konstruktor folgen. Insbesondere können URLs relativ zur Basis-URL sein, die dasbaseURI
des Dokuments im Fensterkontext oderWorkerGlobalScope.location
im Worker-Kontext ist.
Rückgabewert
Ein Promise
, der mit undefined
aufgelöst wird.
Ausnahmen
TypeError
-
Das URL-Schema ist nicht
http
oderhttps
.Der Antwortstatus liegt nicht im 200-Bereich (d. h. keine erfolgreiche Antwort.) Dies tritt auf, wenn die Anfrage nicht erfolgreich zurückkehrt, aber auch, wenn es sich um eine cross-origin no-cors Anfrage handelt (in diesem Fall wird der Status immer als 0 angegeben.)
Beispiele
Dieser Codeblock wartet darauf, dass ein InstallEvent
ausgelöst wird, und führt dann
waitUntil()
aus, um den Installationsprozess für
die App zu bearbeiten. Dies besteht darin, CacheStorage.open
aufzurufen, um einen neuen
Cache zu erstellen, und dann addAll()
zu verwenden, um eine Reihe von Ressourcen hinzuzufügen.
this.addEventListener("install", (event) => {
event.waitUntil(
caches
.open("v1")
.then((cache) =>
cache.addAll([
"/",
"/index.html",
"/style.css",
"/app.js",
"/image-list.js",
"/star-wars-logo.jpg",
"/gallery/",
"/gallery/bountyHunters.jpg",
"/gallery/myLittleVader.jpg",
"/gallery/snowTroopers.jpg",
]),
),
);
});
Spezifikationen
Specification |
---|
Service Workers # cache-addAll |
Browser-Kompatibilität
BCD tables only load in the browser