BackgroundFetchManager

{{APIRef("Background Fetch API")}}{{SeeCompatTable}}{{AvailableInWorkers}}

The BackgroundFetchManager interface of the {{domxref('Background Fetch API','','',' ')}} is a map where the keys are background fetch IDs and the values are {{domxref("BackgroundFetchRegistration")}} objects.

Instance properties

None.

Instance methods

• {{domxref('BackgroundFetchManager.fetch','fetch()' )}} {{Experimental_Inline}}
  • : Returns a {{jsxref("Promise")}} that resolves with a {{domxref("BackgroundFetchRegistration")}} object for a supplied array of URLs and {{domxref("Request")}} objects.
• {{domxref('BackgroundFetchManager.get','get()')}} {{Experimental_Inline}}
  • : Returns a {{jsxref("Promise")}} that resolves with the {{domxref("BackgroundFetchRegistration")}} associated with the provided id or {{jsxref("undefined")}} if the id is not found.
• {{domxref('BackgroundFetchManager.getIds','getIds()')}} {{Experimental_Inline}}
  • : Returns the IDs of all registered background fetches.

Examples

The example below shows how to get an instance of BackgroundFetchManager from a {{domxref("ServiceWorkerRegistration")}} object and calls fetch() to download an audio file in the background.

navigator.serviceWorker.ready.then(async (swReg) => {
  const bgFetch = await swReg.backgroundFetch.fetch(
    "my-fetch",
    ["/ep-5.mp3", "ep-5-artwork.jpg"],
    {
      title: "Episode 5: Interesting things.",
      icons: [
        {
          sizes: "300x300",
          src: "/ep-5-icon.png",
          type: "image/png",
        },
      ],
      downloadTotal: 60 * 1024 * 1024,
    },
  );
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}