Cibler les requêtes

Choisir entre trois modes

L’éditeur propose deux formats du navigateur et un format RequestOrbit plus simple. Le premier suffit le plus souvent :

Une nouvelle règle commence en mode Filtre d’URL. Si la saisie ressemble clairement à une expression régulière, l’éditeur propose de changer de mode sans jamais le faire automatiquement.

• Filtre d’URL (recommandé) : syntaxe native du navigateur pour un domaine, une URL fixe ou un chemin. Elle ne produit pas de valeur $1.
• Joker simplifié : RequestOrbit transforme chaque * en capture. Idéal pour une redirection simple qui conserve une partie de l’URL.
• Expression régulière : pour des captures précises, des alternatives et une logique avancée ; le navigateur actif vérifie sa compatibilité.

Signification de || et ^

Dans un filtre d’URL, || commence au nom de domaine et inclut les sous-domaines. Le ^ placé après le domaine exige un séparateur ou la fin de l’URL : example.com ne correspond donc pas à example.company. Un seul | fixe le début ou la fin, tandis que * correspond à un nombre quelconque de caractères.

Il s’agit de la syntaxe urlFilter de declarativeNetRequest, pas du motif d’autorisation de site WebExtension. RequestOrbit génère ce dernier automatiquement.

            ||example.com^
|https://example.com/app.js|
https://example.com/assets/*
          

Captures et $1 à $9

En mode Joker simplifié, le premier * devient $1, le deuxième $2, etc. En mode Expression régulière, ^ et $ fixent le début et la fin de l’URL, \. désigne un point littéral, .* n’importe quel texte et (...) chaque groupe capturé.

$1 à $9 s’utilisent uniquement dans la destination d’une redirection. Le * du filtre d’URL correspond à du texte, mais ne le capture jamais.

Enfin, limitez davantage la règle par type de ressource, méthode et domaine initiateur. Laisser les types ou méthodes vides signifie qu’ils sont tous acceptés.

            Simple wildcard
Match         https://api.example.com/v1/*
Request       https://api.example.com/v1/users/42
$1 = users/42
Destination   http://localhost:3000/v1/$1

Regular expression
Match         ^https://api\.example\.com/v1/(users|projects)/([^?]+)$
Request       https://api.example.com/v1/projects/alpha
$1 = projects, $2 = alpha
Destination   https://api.example.com/v2/$1/$2