ServiceWorkerContainer.getRegistration

The getRegistration() method of the ServiceWorkerContainer interface gets a ServiceWorkerRegistration object whose scope URL matches the provided document URL. The method returns a Promise that resolves to a ServiceWorkerRegistration or undefined.

Syntax

ServiceWorkerContainer.getRegistration(scope).then(function(ServiceWorkerRegistration) { ... });

Parameters

scope Optional

A unique identifier for a service worker registration — the scope URL of the registration object you want to return. This is usually a relative URL.

Return value

A Promise that resolves to a ServiceWorkerRegistration object, or undefined.

Example

navigator.serviceWorker.getRegistration('/app').then(function(registration) {
  document.querySelector('#status').textContent = 'ServiceWorkerRegistration found.';
});

Specifications

Browser compatibility

[1] Service workers (and Push) have been disabled in the Firefox 45 and 52 Extended Support Releases (ESR.)

[2] Service workers is available in Microsoft Edge starting EdgeHTML 16 behind a flag.