SyncManager: register() method

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

The SyncManager.register method of the SyncManager interface registers a synchronization event, triggering a sync event inside the associated service worker as soon as network connectivity is available.

Syntax

js

register(tag)

Parameters

tag

An identifier for this synchronization event. This will be the value of the tag property of the SyncEvent that gets passed into the service worker's sync event handler.

Return value

A Promise that resolves to undefined.

Examples

The following asynchronous function registers a background sync from a browsing context:

js

async function syncMessagesLater() {
  const registration = await navigator.serviceWorker.ready;
  try {
    await registration.sync.register("sync-messages");
  } catch {
    console.log("Background Sync could not be registered!");
  }
}

Specifications

Specification
Web Background Synchronization
# dom-syncmanager-register

Browser compatibility

BCD tables only load in the browser