From 59715a8d62545fd71932181cf8f03eed49b7f006 Mon Sep 17 00:00:00 2001 From: Pierre Martin Date: Fri, 17 Jul 2026 12:37:37 +0200 Subject: [PATCH] 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. 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 --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index e3c68ac..a7caec3 100644 --- a/README.md +++ b/README.md @@ -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. 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