W3cubDocs

/Web APIs

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

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
register 49 79 No No 36 No 49 49 No 36 No 5.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/SyncManager/register