MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-survey

ServiceWorkerGlobalScope.skipWaiting()

The ServiceWorkerGlobalScope.skipWaiting() method of the ServiceWorkerGlobalScope forces the waiting service worker to become the active service worker.

Use this method with Clients.claim() to ensure that updates to the underlying service worker take effect immediately for both the current client and all other active clients.

Syntax

ServiceWorkerGlobalScope.skipWaiting().then(function() {
  //Do something
});

Returns

A Promise that immediately resolves with undefined.

Example

While self.skipWaiting() can be called at any point during the service worker's execution, it will only have an effect if there's a newly installed service worker that might otherwise remain in the waiting state. Therefore, it's common to call self.skipWaiting() from inside of an InstallEvent handler.

The following example causes a newly installed service worker to progress into the activating state, regardless of whether there is already an active service worker.

self.addEventListener('install', function(event) {
  // The promise that skipWaiting() returns can be safely ignored.
  self.skipWaiting();

  // Perform any other actions required for your
  // service worker to install, potentially inside
  // of event.waitUntil();
});

Specifications

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

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 42 44.0 (44.0)[1] No support 29 No support
Feature Android Chrome for Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile
Basic support 42 42 44.0 (44.0) (Yes) No support 29 No support

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

See also

Document Tags and Contributors

 Last updated by: chrisdavidmills,