W3cubDocs

/Web APIs

BackgroundFetchManager

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The BackgroundFetchManager interface of the Background Fetch API is a map where the keys are background fetch IDs and the values are BackgroundFetchRegistration objects.

Instance properties

None.

Instance methods

fetch() Experimental

Returns a Promise that resolves with a BackgroundFetchRegistration object for a supplied array of URLs and Request objects.

get() Experimental

Returns a Promise that resolves with the BackgroundFetchRegistration associated with the provided id or undefined if the id is not found.

getIds() Experimental

Returns the IDs of all registered background fetches.

Examples

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

js

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

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
BackgroundFetchManager 74 79 No No 62 No No 74 No 53 No 11.0
fetch 74 79 No No 62 No No 74 No 53 No 11.0
get 74 79 No No 62 No No 74 No 53 No 11.0
getIds 74 79 No No 62 No No 74 No 53 No 11.0

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BackgroundFetchManager