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) {
  if(registration){
    document.querySelector('#status').textContent = 'ServiceWorkerRegistration found.';
  }
});

Specifications

Specification Status Comment
Service Workers
The definition of 'ServiceWorkerContainer: getRegistration' in that specification.
Working Draft Initial definition.

Browser compatibility

BCD tables only load in the browser