Skip to content
On this page

Service Worker Strategies And Behaviors

A service worker strategy is related to how the vite-plugin-pwa plugin will generate your service worker, while the behavior of a service worker is related to how the service worker will work in the browser once the browser detects a new version of your application.

Service Worker Strategies

As we mention in Configuring vite-plugin-pwa section, vite-plugin-pwa plugin will use workbox-build node library to generate your service worker. There are 2 available strategies, generateSW and injectManifest:

  • generateSW: the vite-plugin-pwa will generate the service worker for you, you don't need to write the code for the service worker
  • injectManifest: the vite-plugin-pwa plugin will compile your custom service worker and inject its precache manifest

To configure the service worker strategy, use the strategies' plugin option with generateSW (default strategy) or injectManifest value.

You can find more information about the strategies in the generateSW or injectManifest Workbox sections.

Service Worker Behaviors

The behavior of the service worker will help you to update the application in the browser, that is, when the browser detects a new version of your application, you can control how the browser updates it.

You may want to not bother users and just have the browser update the application when there is a new version: the user will only see a reload of the page they are on.

Or you may want to inform the user that there is a new version of the application, and let the user decide when to update it: simply because you want it to behave that way or because your application requires it (for example, to prevent data loss if the user is filling out a form).

To configure the service worker behavior, use the registerType plugin option with autoUpdate or prompt (default strategy) value.

You can find more information about the behaviors in the auto-update or prompt-for-update sections for generateSW strategy or in inject-manifest section for injectManifest strategy.

Released under the MIT License.