the Chromium logo

The Chromium Projects

Getting Started

For web developer documentation, see:

If you are a Chromium developer, read on!

Here's how to get a demo Service Worker up and running:


  1. Open the demo at (source)
  2. Open the Inspector. Things are logged there later on.
  3. Try visiting Cleveland and get a 404. Go back.
  4. Click the 'Register' button, watch the Inspector console, then try visiting Cleveland again... oooh.
  5. Go to chrome://inspect#service-workers and click on Inspect to open the Inspector and debug your Service Worker.

Running it locally

How to run a local server

On a system with python:

$ python -m SimpleHTTPServer 8080

On Android use Chrome Developer Tools' port forwarding.

Development flow

In order to guarantee that the latest version of your Service Worker script is being used, follow these instructions:

  1. Configure your local server to serve your Service Worker script as non-cacheable (cache-control: no-cache)
  2. After you made changes to your service worker script:
    1. close all but one of the tabs pointing to your web application
    2. hit shift-reload to bypass the service worker as to ensure that the remaining tab isn't under the control of a service worker
    3. hit reload to let the newer version of the Service Worker control the page.