BackgroundFetchManager: get() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Note: This feature is available in Web Workers.

The get() method of the BackgroundFetchManager interface returns a Promise that resolves with the BackgroundFetchRegistration associated with the provided id or undefined if the id is not found.

Syntax

js
get(id)

Parameters

id

The ID of a BackgroundFetchRegistration defined by calling fetch().

Return value

A Promise that resolves with a BackgroundFetchRegistration or undefined.

Examples

The following examples shows how to use get() to retrieve a BackgroundFetchRegistration. With an active service worker, use the ServiceWorkerRegistration.backgroundFetch to access the BackgroundFetchManager object and call its get() method.

js
navigator.serviceWorker.ready.then(async (swReg) => {
  const bgFetch = await swReg.backgroundFetch.get("my-fetch");
});
// my code block

Specifications

Specification
Background Fetch
# background-fetch-manager-get

Browser compatibility

BCD tables only load in the browser