Simple Service Worker Setup

If you’ve been paying attention to new technologies on the web one thing you have not missed is Service Workers. They’re a new take on the idea of progressive enhancement and I think they’re going to stick around for a while yet.

Workers on the page

The idea of a web worker is not new, and is currently used to help move large amounts of computation off the main thread. People tend to use them when they want to do large calculations in the background without affecting render performance.

Web workers are just JavaScript as well which makes them very easy to understand and start using. If you have not looked into the idea of a promise in the browser I would suggest this resource from Mozilla.

Simple service worker

Here’s a really simple service worker that will work on any page if you add the basic assets in the array that gets cached. You also need to add the install script to the webpage that gets served to your users on their initial visit.

// index.html - install the service worker
if ('serviceWorker' in navigator) {
    window.addEventListener('load', function() {
        navigator.serviceWorker.register('/sw.js').then(function(registration) {
            console.log('ServiceWorker registration successful with scope: ', registration.scope);
        }).catch(function(err) {
            console.log('ServiceWorker registration failed: ', err);

This checks to see if the browser supports the API and then installs the service worker from /sw.js. It also removes the old cache if you bump up the version number ensuring your users download new assets if you want to make an update.

// sw.js
var SITE_NAME = 'your-site'
var CACHE_NAME = SITE_NAME + '-1';
var urlsToCache = [

self.addEventListener('install', function(event) {
  // Perform install steps
      .then(function(cache) {
        console.log('Opened cache');
        return cache.addAll(urlsToCache)

self.addEventListener('activate', function(event) {
    caches.keys().then(function(cacheNames) {
      return Promise.all( {
          if (CACHE_NAME !== cacheName 
                && cacheName.startsWith(SITE_NAME)) {
            return caches.delete(cacheName);

self.addEventListener('fetch', function(event) {
      .then(function(response) {
        if (response) {
          return response;
        return fetch(event.request);

This will install a service worker that serves up your index.html and main CSS and JavaScript assets. Next time you load the page it will appear offline. The key events are installing the cache, an activate event that clears the old cache, and a fetch event that interrupts network requests.

Updating the worker

You will find yourself wanting to update assets at some point and might be frustrated when your service worker refuses to download the new version of things. It is possible to do a background fetch for new resources and replace that item in the cache, but there is a simpler way.

You can just bump up the version of the sw.js at the top such as:

var SITE_NAME = 'your-site'
var CACHE_NAME = SITE_NAME + '-1';


var SITE_NAME = 'your-site'
var CACHE_NAME = SITE_NAME + '-2';

This works because when the browser checks the sw.js file and whether it should install the new version, it checks to see if they are byte equivalent. Changing a number will prompt a reinstall.


This technology is really new, and there’s a bunch of tools made by google that substantially extend the functionality by adding offline support for messaging and even google analytics. You can also add support for caching fonts based on the response from google and even CDN based resources.

The point of this post is to show that it’s very easy to add a simple service worker to your site. Hopefully in the future all sites will have some sort of offline ability, and with phones having more and more storage space, it wouldn’t be unreasonable for you to cache your most visited sites to have an uninterrupted experience on the web.

blog service worker progressive easy
Share this post on Twitter