This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
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
Specification | Status | Comment |
---|---|---|
Service Workers The definition of 'ServiceWorkerContainer' in that specification. |
Editor's Draft | Initial definition. |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Basic support | 40 | (Yes)[2] | 44.0 (44.0)[1] | No support | 24 | No support |
Feature | Android Webview | Chrome for Android | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Basic support | No support | 40 | 44.0 (44.0) | (Yes) | No support | ? | No support |
[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.