CacheStorage: open()-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: Diese Funktion ist in Web Workers verfügbar.

Die open()-Methode der CacheStorage-Schnittstelle gibt ein Promise zurück, das auf das Cache-Objekt aufgelöst wird, das dem cacheName entspricht.

Sie können auf CacheStorage über die Window.caches-Eigenschaft in Fenstern oder über die WorkerGlobalScope.caches-Eigenschaft in Workern zugreifen.

Hinweis: Wenn das angegebene Cache nicht existiert, wird ein neues Cache mit diesem cacheName erstellt und ein Promise zurückgegeben, das auf dieses neue Cache-Objekt aufgelöst wird.

Syntax

js
open(cacheName)

Parameter

cacheName

Der Name des Caches, den Sie öffnen möchten.

Rückgabewert

Ein Promise, das auf das angeforderte Cache-Objekt aufgelöst wird.

Beispiele

Dieses Beispiel stammt aus dem MDN einfachen Service Worker Beispiel (siehe einfacher Service Worker in Betrieb). Hier warten wir darauf, dass ein InstallEvent ausgelöst wird und führen dann waitUntil() aus, um den Installationsprozess für die App zu handhaben. Dies besteht darin, CacheStorage.open() aufzurufen, um einen neuen Cache zu erstellen, und dann Cache.addAll() zu verwenden, um eine Reihe von Ressourcen hinzuzufügen.

js
self.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/bountyHunters.jpg",
          "/gallery/myLittleVader.jpg",
          "/gallery/snowTroopers.jpg",
        ]),
      ),
  );
});

Spezifikationen

Specification
Service Workers
# cache-storage-open

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch