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:
co-authored by
Claude Opus 4.8
parent
b2361fcfb9
commit
59715a8d62
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user