Service Worker Best Practices

Scope and Activation Keywords

Use this specification as a priority when the Agent or developer needs to handle the following tasks:

• Adjusting or designing Service Worker cache routing, TTL, cache capacity, and partitioning rules.
• Adjusting page-level Service Worker registration, auto-activation, and force-update reload logic.
• Configuring, optimizing, or troubleshooting critical first-screen API caching (Stale-While-Revalidate).
• Handling online Service Worker self-healing failures, rollbacks, and emergency clearing of specific cache buckets.

Typical activation keywords: "modify cache rules", "add API cache", "SW troubleshooting", "PWA cache optimization", "clear SW", "MAGIC_SW_MODE", "MAGIC_SW_CLEAR_CACHES".

1. Core Design Philosophy and Security Gates

When handling Service Worker development for this repository, the following design philosophy and security gates must be strictly followed to prevent cache pollution and accidental interception risks: