Modèle de correspondance d’URL

Last Updated juin 2, 2026

Aperçu général

Les modèles de correspondance vous permettent de spécifier des groupes d'URL auxquels une extension de navigateur doit s'appliquer. Chaque modèle de correspondance correspond à un ensemble spécifique d'URL.

Structure du modèle de correspondance

Tous les modèles de correspondance sont spécifiés sous forme de chaînes et se composent de trois parties : le schéma, l'hôte et le chemin. Le schéma et l'hôte sont séparés par ://.

<schéma>://<hôte><chemin d'accès>

Schéma

Le schéma peut être http ou https.

Hôte

Le composant hôte prend l'une des trois formes suivantes :

  • * — Correspond à n'importe quel hôte
  • *. suivie d'une partie du nom d'hôte — Correspond à l'hôte donné et à l'un de ses sous-domaines
  • Un nom d'hôte complet sans caractères génériques — Correspond uniquement à l'hôte donné
Remarque

L'hôte ne doit pas inclure de numéro de port. Le caractère générique peut apparaître uniquement au début.

Chemin

Le chemin doit commencer par /. Après cela, il peut contenir n'importe quelle combinaison de caractère générique * et de tous les caractères autorisés dans les chemins d'URL ou les chaînes de requête. Contrairement à l'hôte, le chemin peut contenir le caractère générique * au milieu ou à la fin, et les caractères génériques peuvent apparaître plus d'une fois.

Le chemin correspond au chemin d'URL plus la chaîne de requête URL, y compris le ? entre les deux si une chaîne de requête est présente.

Par exemple, pour faire correspondre les URL sur n'importe quel domaine où le chemin se termine par foo.bar, utilisez un tableau de modèles de correspondance tels que ['*://*/*foo.bar', '*://*/*foo.bar?*']. Le ?* ancre la terminaison * à la chaîne de requête plutôt qu'au chemin d'URL.

Remarque

  • Les identifiants de fragment d'URL et le # qui les précède ne sont pas considérés comme faisant partie du chemin.
  • La chaîne de caractères du chemin d'accès ne doit pas inclure de numéro de port. L'ajout d'un port, par exemple, http://localhost:1234/*, fait en sorte que le modèle de correspondance soit ignoré. Cependant, http://localhost:1234 correspond à http://localhost/*.

Exemples

Motif Exemple de correspondance Exemple de non-correspondance

https://*/path

Faire correspondre les URL HTTPS sur n'importe quel hôte, dont le chemin d'accès est « chemin d'accès ».

https://mozilla.org/path

https://a.mozilla.org/path

https://something.com/path

http://mozilla.org/path
(schéma non correspondant) https://mozilla.org/path/
(chemin d'accès non apparié) https://mozilla.org/a
(chemin non correspondant) https://mozilla.org/
(chemin non correspondant) https://mozilla.org/path?foo=1
(chemin d'accès non correspondant en raison de la chaîne de requête de l'URL)

https://*/path/

Faire correspondre les URL HTTPS sur n'importe quel hôte, dont le chemin d'accès est « chemin d'accès/ » et qui n'a pas de chaîne de requête d'URL.

https://mozilla.org/path/

https://a.mozilla.org/path/

https://something.com/path/

http://mozilla.org/path/
(schéma non correspondant) https://mozilla.org/path
(chemin d'accès non apparié) https://mozilla.org/a
(chemin non correspondant) https://mozilla.org/
(chemin non correspondant) https://mozilla.org/path/?foo=1
(chemin d'accès non correspondant en raison de la chaîne de requête de l'URL)

https://mozilla.org/*

Faire correspondre les URL HTTPS uniquement à « mozilla.org », avec n'importe quel chemin d'accès et chaîne de requête d'URL.

https://mozilla.org/

https://mozilla.org/path

https://mozilla.org/another

https://mozilla.org/path/to/doc

https://mozilla.org/path/to/doc?foo=1

http://mozilla.org/path
(schéma non apparié) https://mozilla.com/path
(hôte non apparié)

https://mozilla.org/a/b/c/

Faire correspondre uniquement cette URL ou cette URL avec n'importe quel fragment d'URL.

https://mozilla.org/a/b/c/

https://mozilla.org/a/b/c/#section1

Tout autre élément.

https://mozilla.org/*/b/*/

Faire correspondre les URL HTTPS hébergées sur « mozilla.org », dont le chemin d'accès contient un composant « b » quelque part au milieu. Fera correspondre les URL avec des chaînes de requête, si la chaîne se termine par un /.

https://mozilla.org/a/b/c/

https://mozilla.org/d/b/f/

https://mozilla.org/a/b/c/d/

https://mozilla.org/a/b/c/d/#section1

https://mozilla.org/a/b/c/d/?foo=/

https://mozilla.org/a?foo=21314&bar=/b/&extra=c/

https://mozilla.org/b/*/
(chemin non correspondant) https://mozilla.org/a/b/
(chemin non correspondant) https://mozilla.org/a/b/c/d/?foo=bar
(chemin non correspondant en raison de la chaîne de requête d'URL)

Modèles de correspondance invalides

  • resource://path/ — Schéma non pris en charge.
  • https://mozilla.org — Aucun chemin.
  • https://mozilla.*.org/* dans l'hôte doit être au début.
  • https://*zilla.org/* dans l'élément hôte doit être le seul caractère ou être suivi de ..
  • http*://mozilla.org/* dans le schéma doit être le seul caractère.
  • https://mozilla.org:80/ — L'hôte ne doit pas inclure de numéro de port.
  • https://* — Chemin vide : il doit s'agir de https://*/*.

Modèle de correspondance d'URL vs Regex

WalkMe vous permet de configurer les extensions à l'aide du modèle de correspondance des URL ou de Regex. Voici comment ils se comparent.

Modèle de correspondance des URL

Le modèle de correspondance d'URL est créé spécifiquement pour les extensions de navigateur. Il utilise une syntaxe simple avec des caractères génériques pour définir les URL auxquelles une extension doit s'appliquer, par exemple, les scripts de contenu ou les scripts d'arrière-plan.

Regex

Regex (expression régulière) est un outil puissant et polyvalent pour la correspondance des modèles dans les chaînes. Il vous permet de rechercher, d'extraire ou de remplacer du texte à l'aide d'une combinaison de caractères et de métacaractères. Il est largement utilisé dans le traitement de texte, la validation des données et la programmation.

Comparaison

Le modèle de correspondance d'URL à but spécifique est créé et optimisé pour les navigateurs Web pour définir les URL auxquelles une extension de navigateur doit s'appliquer.
Regex est un outil puissant pour la correspondance de modèles dans les chaînes, à l'aide d'une combinaison de caractères et de métacaractères.

Le modèle de correspondance des URL d'utilisation est utilisé par les extensions de navigateur pour spécifier les pages Web sur lesquelles elles doivent fonctionner.
Regex peut être utilisé dans un large éventail d'applications, telles que le traitement de texte, la validation des données et les opérations de recherche et de remplacement.

Le modèle de correspondance d'URL de syntaxe utilise des caractères génériques tels que * et ? pour spécifier les modèles d'URL. Regex utilise des métacaractères tels que . (n'importe quel caractère), * (zéro ou plusieurs occurrences) et + (une ou plusieurs occurrences).

Exemple de modèle de correspondance d'URL : https://example.com/* correspond à n'importe quelle URL commençant par https://example.com/. Regex : ^(http|https)://example\.com(?:/[^/?#]+)*$ correspond aux URL appartenant à example.com.

Avantages et inconvénients

Modèle de correspondance d'URL — avantages

  • Simple et intuitif pour la correspondance d'URL
  • Plus lisible que les regex complexes
  • La norme recommandée pour les extensions de navigateur

Modèle de correspondance d'URL — inconvénients

  • Limité à la correspondance d'URL uniquement
  • Non adapté à la correspondance de modèles à usage général
  • Conçu spécifiquement pour les extensions de navigateur

Regex — avantages

  • Polyvalent pour un large éventail de tâches de correspondance de modèles
  • Syntaxe riche pour une correspondance très précise
  • Peut gérer les modèles complexes au-delà des structures d'URL

Regex — inconvénients

  • Les expressions complexes peuvent être difficiles et sujettes aux erreurs
  • Les modèles extrêmement complexes peuvent causer des problèmes de performance
  • Difficile à lire et à maintenir

Recommandation WalkMe

WalkMe recommande d'utiliser le modèle de correspondance des URL pour la configuration de l'extension dans la mesure du possible. Les regex devraient être un dernier recours pour les cas limites. Le modèle de correspondance d'URL garantit une fonctionnalité d'extension transparente, minimise la validation des règles en arrière-plan et fournit une meilleure expérience dans l'ensemble.

Le modèle de correspondance d'URL est le modèle par défaut pour toute nouvelle configuration du système dans les paramètres de l'extension d'administration.

Cet article a-t-il été utile?

Merci pour votre avis!

Be part of something bigger.

Engage with peers, ask questions, share ideas

Ask the Community
×