Service Workers (web workers, etc.) are a relatively new concept. They can do all kinds of cool things (primarily related to network requests), but they are also the mechanism by which a web site can receive push messages (via Web Push) and show them as OS notifications.
The general rule of Service Workers is to pick a file name (such as "/service-worker.js") and never, ever change it. That's cool, but sometimes you do need to change it.
In particular, I started my push messaging journey with "platinum-push-messaging", a now-defunct web component built by Google as part of the initial Polymer project. The promise was cool: just slap this HTML element on your page with a few parameters and boom: you have working push notifications.
When it came out, the push messaging spec was young, and no browsers fully supported its encrypted data payloads, so "platinum-push-messaging" did a lot of work to work around that limitation. As browsers improved to support the VAPID spec, "platinum-push-messaging" (along with all of the other "platinum" elements) were quietly deprecated and archived (around 2017).
This left me with a problem: a rotting push notification system that couldn't keep up with the spec and the latest browsers. I hacked the code to all hell to support VAPID and keep the element functioning, but I was just punting.
Here was my problem:
- I wanted the push messaging Service Worker under my control at the top level of my application, "/push-service-worker.js".
- I had hundreds of users who were receiving push notifications via this system, and the upgrade had to be seamless (users couldn't be forced to take any action).
- I had my application store the Web Push subscription info in HTML local storage. This would be necessary later as part of the switcheroo.
- I removed "bower_components/platinum-push-messaging/". Any existing clients would regularly attempt to update the service worker, but it would quietly fail, leaving the existing one running just fine.
- I removed all references to "platinum-push-messaging" from my code. The existing Service Worker would continue to run (because that's what Service Workers do) and receive push messages (and show notifications).
- I made my own push-messaging web component with my own service worker living at "/push-service-worker.js".
- (This laid the framework for performing the switcheroo.)
- Upon loading, the part of my application that used to include "platinum-push-messaging" did a migration, if necessary, before loading the new push-messaging component:
- It went through all the Service Workers and looked for any legacy ones (these had "$$platinum-push-messaging$$" in the scope). If it found any, it killed them.
Note that the "$$platinum-push-messaging$$" in the scope was a cute trick by the web component: a page can only be controlled by one Service Worker, and the scope dictates what that Service Worker can control. By injecting a bogus "$$platinum-push-messaging$$" at the end of the scope, it ensured that the push-messaging Service Worker couldn't accidentally control any pages and get in the way of a main Service Worker.
- Upon finding any legacy Service Workers, it would:
- Issue a delete to the web server for the old (legacy) subscription (which was stored in HTML local storage).
- Tell the application to auto-enable push notifications.
- Resume the normal workflow for the application.
- The normal workflow for the application entailed loading the new push-messaging web component once the user was logged in. If a Service Worker was previously enabled, then it would remain active and enabled. Otherwise, the application wouldn't try to annoy users by asking them for push notifications.
- After the new push-messaging web component was included, it would then check to see if it should be auto-enabled (it would only be auto-enabled as part of a successful migration).
- If it was auto-enabled, then it would enable push messaging (the user would have already given permission by virtue of having a legacy push Service Worker running). When the new push subscription was ready, it would post that information to the web server, and the user would have push messages working again, now using the new Service Worker. The switcheroo was complete.
- They open up the application after it has been upgraded. The application prompts them to reload to upgrade if it detects a new version, but eventually the browser will do this on its own, typically after the device reboots or the browser has been fully closed.
- They click on a push notification, which opens up the application (which is #1, above).