November 15, 2018

360 words 2 mins read

zackargyle/service-workers

zackargyle/service-workers

A collection of utilities for creating/testing/experimenting with service workers.

repo name zackargyle/service-workers
repo link https://github.com/zackargyle/service-workers
homepage
language JavaScript
size (curr.) 194 kB
stars (curr.) 1237
created 2017-01-11
license MIT License

Service Worker Toolchain

A collection of service worker generation tools. Configurable and forkable.

Includes the following packages

generate-service-worker

A node module for generating service worker files based on provided configuration options.

service-worker-plugin

A webpack plugin for generating dynamic service worker files and a runtime helper.

service-worker-mock

A mock service worker environment generator. Used for testing service worker code.

Why?

There are several other packages that generate service workers (sw-precache, offline-plugin, etc). This collection of tools was built to allow more complexity while being fully testable, and allowing the generation of multiple service worker files simultaneously for experimentation/rollout. We chose not to use a templating language, but to instead inject globals into the scripts so that our “templates” were pure JavaScript. This makes it easier to test/read/update the code, with the downside of slightly larger output sizes. See the README in each package for more details.

We encourage forking of the base templates found in packages/generate-service-worker/templates/.

Contributing

scripts description
yarn install install all dev dependencies
yarn test run the test suite
yarn run lint run eslint
yarn start run the demo for development testing

To get started contributing, run yarn start, which will run a webpack-devserver on localhost:3000. In demo/webpack.config.js you’ll see the configurations used for the demo testing. Each experimental config can be accessed via the key query param (i.e. localhost:3000?key=withNotifications). This provides a simple way to install a new service worker for testing, and the corresponding generated code will be visible in the DOM itself thanks to highlight.js. Use the application tab in the devtools to verify that the service worker was installed. By setting debug: true in the plugin config, the devtools console can be used to verify actions are taking place.

Core Contributors

Contributors ✌⊂(✰‿✰)つ✌

Some ideas for contributions:

  • Browserify plugin
  • Rollup plugin

License

MIT

comments powered by Disqus