Skip to content

docs: fix misleading MV3 reference and add Compatibilité & Roadmap section#124

Merged
ormidales merged 2 commits into1.0.7from
copilot/update-manifest-to-mv3
Mar 10, 2026
Merged

docs: fix misleading MV3 reference and add Compatibilité & Roadmap section#124
ormidales merged 2 commits into1.0.7from
copilot/update-manifest-to-mv3

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Mar 10, 2026

The README claimed declarativeNetRequest (MV3) as part of the current stack, while the extension actually uses webRequestBlocking (MV2-only). This creates confusion about the technical strategy.

Changes

  • Stack Technique — corrected the WebExtensions API bullet to accurately reflect the current implementation: webRequest + webRequestBlocking (Manifest V2)
  • New Compatibilité & Roadmap section — adds:
    • Browser support table (Firefox: indefinite MV2 support; Chrome: deprecated since v127)
    • Pourquoi pas Manifest V3? subsection explaining the two hard blockers: no synchronous request cancellation and no dynamic response-header inspection in declarativeNetRequest
    • Statement that MV3 migration is deferred until the API reaches feature parity
## Compatibilité & Roadmap

L'extension utilise actuellement **Manifest V2** avec `webRequestBlocking`| Navigateur | Support MV2          | Calendrier de fin de support |
|------------|----------------------|------------------------------|
| Firefox    | ✅ Maintenu à long terme | Indéfini (engagement Mozilla) |
| Chrome     | ⚠️ Déprécié           | Retiré depuis Chrome 127 (juin 2024) … |

### Pourquoi pas Manifest V3 ?
Original prompt

This section details on the original issue you should resolve

<issue_title>[PATCH] manifest_version 2 déprécié — absence de roadmap MV3 dans le README</issue_title>
<issue_description>Catégorie : documentation
Sévérité : patch
Fichier(s) concerné(s) : manifest.json (l.2), README.md

Description

Le manifest utilise manifest_version: 2, déprécié dans Chrome (et en cours de dépréciation progressive dans Firefox). Le README mentionne declarativeNetRequest (API MV3) comme alternative à webRequest mais l'extension utilise actuellement webRequest avec webRequestBlocking (MV2 uniquement). Cette incohérence peut induire les contributeurs en erreur sur la stratégie technique à long terme.

Exemple de code problématique

// manifest.json
{ "manifest_version": 2 }

// README.md mentionne declarativeNetRequest (MV3) sans clarifier que c'est une piste future

Solution suggérée

Ajouter une section "Roadmap" ou "Compatibilité" dans le README clarifiant :

  1. L'usage actuel de MV2 / webRequestBlocking
  2. Les limitations de declarativeNetRequest (MV3) pour ce cas d'usage (accès limité aux headers de réponse)
  3. Le support Firefox de MV2 à long terme
## Compatibilité & Roadmap

L'extension utilise actuellement Manifest V2 avec `webRequestBlocking`,
seule API permettant l'inspection et l'annulation synchrone des redirections HTTP.
La migration vers Manifest V3 (`declarativeNetRequest`) est à l'étude,
mais l'API MV3 ne supporte pas encore l'annulation dynamique basée sur les headers de réponse.
Firefox maintient le support MV2 pour les extensions de fond indéfiniment.

Critères d'acceptation

  • Le README documente explicitement l'usage de MV2 et les raisons du choix
  • La mention de declarativeNetRequest est contextualisée comme piste future, non comme implémentation actuelle
  • Une section "Compatibilité navigateurs" précise le support Firefox/Chrome</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

…ADME

Co-authored-by: ormidales <46538211+ormidales@users.noreply.github.com>
Copilot AI changed the title [WIP] Update manifest version to MV3 and improve README docs: fix misleading MV3 reference and add Compatibilité & Roadmap section Mar 10, 2026
@ormidales ormidales added this to the v1.0.7 milestone Mar 10, 2026
@ormidales ormidales linked an issue Mar 10, 2026 that may be closed by this pull request
3 tasks
@ormidales ormidales marked this pull request as ready for review March 10, 2026 13:52
Copilot AI review requested due to automatic review settings March 10, 2026 13:52
@ormidales ormidales merged commit 1f74b0e into 1.0.7 Mar 10, 2026
@ormidales ormidales deleted the copilot/update-manifest-to-mv3 branch March 10, 2026 13:52
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the README to accurately describe the extension’s current Manifest V2 networking approach and to clarify MV2/MV3 browser compatibility and migration constraints.

Changes:

  • Corrects the “Stack Technique” WebExtensions API bullet to reflect webRequest + webRequestBlocking (MV2) rather than MV3’s declarativeNetRequest.
  • Adds a “Compatibilité & Roadmap” section with a browser support table and a rationale for deferring MV3 migration due to missing capabilities for this use case.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md

* **API WebExtensions** : Utilisation de l'API `declarativeNetRequest` (ou `webRequest` avec blocage) pour l'interception performante des requêtes réseau au niveau du navigateur.
* **API WebExtensions** : Utilisation de l'API `webRequest` avec `webRequestBlocking` (Manifest V2) pour l'interception synchrone et l'annulation des requêtes réseau au niveau du navigateur.
* **JavaScript Vanilla (ES2022)** : Garantit une exécution rapide et légère du background worker sans surcharge liée à un framework externe.
Copy link

Copilot AI Mar 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

La formulation « background worker » est trompeuse ici : en Manifest V2, l’extension utilise une page/script de fond (cf. manifest.json → background.scripts), pas un service worker (MV3). Pour éviter la confusion, remplacer par « script de fond », « page de fond » ou « background script (MV2) ».

Suggested change
* **JavaScript Vanilla (ES2022)** : Garantit une exécution rapide et légère du background worker sans surcharge liée à un framework externe.
* **JavaScript Vanilla (ES2022)** : Garantit une exécution rapide et légère du script de fond (background script, MV2) sans surcharge liée à un framework externe.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[PATCH] manifest_version 2 déprécié — absence de roadmap MV3 dans le README

3 participants