docs: warn that a manifest change needs a full reinstall

Firefox re-reads page scripts on every open but the manifest only at
install time. A "Reload" leaves the newest code running with the old
permission set, surfacing as `browser.<api> is undefined` despite a
correct manifest. This trap cost two test passes on T1; T2 adds a
CalDAV permission and would hit it next.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Pierre Martin
2026-07-17 12:37:37 +02:00
co-authored by Claude Opus 4.8
parent b2361fcfb9
commit 59715a8d62
+12
View File
@@ -38,6 +38,18 @@ runtime à installer) :
> ⚠️ Un module temporaire **disparaît au redémarrage de Firefox** : il faut le
> recharger via `about:debugging` à chaque session (comportement de dev attendu).
> 🔴 **Après toute modification de `manifest.json` (permission ajoutée…) :
> *Décharger* puis *Charger* le module. « Recharger » et F5 ne suffisent pas.**
> Firefox relit les **scripts** de la page à chaque ouverture, mais le
> **manifest** seulement **à l'installation** : on se retrouve sinon avec le code
> le plus récent et les **permissions figées de l'ancien**.
> Symptôme : `browser.<api> is undefined` alors que le manifest déclare bien la
> permission. Piège de **dev uniquement** (en module signé, les permissions
> déclarées sont accordées d'office) — mais il a déjà coûté deux passes de test.
>
> Pense aussi à **fermer les anciens onglets de la liste** avant de recharger :
> une page orpheline rend les clics inertes.
### Vérifier l'extension
```sh