Motifs (Match patterns)

Les modèles de correspondance sont un moyen de spécifier des groupes d'URL : un modèle de correspondance correspond à un ensemble spécifique d'URL. Ils sont destinés à des extensions à l'aide d'API WebExtensions dans quelques endroits, notamment pour spécifier les documents dans lesquels charger des content scripts, et pour spécifier les URL à ajouter aux auditeurs webRequest.

Les API qui utilisent des modèles de correspondance acceptent généralement une liste de modèles de correspondance et effectueront les actions appropriées si l'URL correspond à l'un des motifs. Voir, par exemple, la clé content_scripts dans manifest.json.

Structure du modèle de correspondance

Note : Certains navigateurs ne prennent pas en charge certains schémas. Consultez le tableau de compatibilité du navigateur pour plus de détails.

Tous les modèles de correspondance sont spécifiés comme des chaînes. Outre le motif spécial « <all_urls> », les modèles de correspondance se composent de trois partie : schéma, l'hôte, et le chemin d'accès. Le schéma et l'hôte sont séparés par « :// ».

<scheme>://<host><path>

schéma

Le composant du schéma peut prendre l'une des deux formes suivantes :

Valeur Correspondances
* Seulement "http" et "https" et dans certains navigateurs "ws" et "wss" aussi.
Une parmi http, https, ws, wss, ftp, ftps, data ou file. Seulement le schéma donné.

hôte

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

Valeur Correspondances
* Tout hôte
*. Suivi d'une partie du nom d'hôte L'hôte donné et l'un de ses sous-domaines
Un nom d'hôte complet, sans caractères génériques Seul l'hôte donné

L'hôte ne doit pas inclure un numéro de port.

L'hôte est facultatif seulement si le schéma est un « fichier ».

Notez que le caractère générique ne peut apparaître qu'au début.

chemin

Le composant du chemin d'accès doit commencer par un /.

Ensuite, il peut contenir éventuellement toute combinaison du caractère générique * et de l'un des caractères autorisés dans les chemins d'URL ou chaînes de requête. Contrairement à l'hôte, le composant du chemin peut contenir le caractère générique * au milieu ou à la fin, et le caractère * peut apparaître plusieurs fois.

La valeur du chemin matches correspond à la chaîne de caractères qui est le chemin plus la chaine de requête URL. Ceci inclut le signe ? entre les deux, si la chaîne de requête est présente dans l'URL. Par exemple, si vous voulez faire correspondre des URLs sur n'importe quel domaine où le chemin URL se termine par foo.bar, alors vous devez utiliser un tableau de Match Patterns comme ['*://*/*foo.bar', '*://*/*foo.bar?*']. Le ?* est nécessaire, plutôt que juste la bar*, afin d'ancrer la fin * comme s'appliquant à la chaîne de requête URL et non à une partie du chemin URL.

Ni l'identificateur de fragment d'URL, ni le # qui le précède, ne sont considérés comme faisant partie du chemin.

Note : La chaîne de modèle de chemin d'accès ne doit pas inclure de numéro de port. Ajout d'un port, comme dans : http://localhost:1234/* fait que le motif de match est ignoré. Cependant, http://localhost:1234 correspondra avec http://localhost/*.

<all_urls>

La valeur spéciale <all_urls> correspond à toutes les URL sous l'un des schémas pris en charge, c'est‐à‐dire : "http", "https", "ws", "wss", "ftp", "data" et "file".

Exemples

Modèle Exemples de correspondances Exemples de non-correspondances

<all_urls>

Correspondance à toutes les URL

http://example.org/

https://a.org/some/path/

ws://sockets.somewhere.org/

wss://ws.example.com/stuff/

ftp://files.somewhere.org/

ftps://files.somewhere.org/

resource://a/b/c/
(schéma sans équivalent)

*://*/*

Correspondance à toutes les URLs HTTP, HTTPS et WebSocket

http://example.org/

https://a.org/some/path/

ws://sockets.somewhere.org/

wss://ws.example.com/stuff/

ftp://ftp.example.org/
(schéma sans équivalent)

ftps://ftp.example.org/
(schéma sans équivalent)

file:///a/
(schéma sans équivalent)

*://*.mozilla.org/*

Correspondance à toutes les URLs HTTP, HTTPS et WebSocket URLs qui sont hébergés sur "mozilla.org" ou l'un de ses sous-domaines.

http://mozilla.org/

https://mozilla.org/

http://a.mozilla.org/

http://a.b.mozilla.org/

https://b.mozilla.org/path/

ws://ws.mozilla.org/

wss://secure.mozilla.org/something

ftp://mozilla.org/
(schéma sans équivalent)

http://mozilla.com/
(hôte sans équivalent)

http://firefox.org/
(hôte sans équivalent)

*://mozilla.org/

Correspondance à toutes les URLs HTTP, HTTPS and WebSocket qui sont hébergés exactement chez "mozilla.org/"

http://mozilla.org/

https://mozilla.org/

ws://mozilla.org/

wss://mozilla.org/

ftp://mozilla.org/
(schéma sans équivalent)

http://a.mozilla.org/
(hôte sans équivalent)

http://mozilla.org/a
(chemin sans équivalent)

ftp://mozilla.org/

Correspondance seulement à "ftp://mozilla.org/".

 ftp://mozilla.org

http://mozilla.org/
(schéma sans équivalent)

ftp://sub.mozilla.org/
(hôte sans équivalent)

ftp://mozilla.org/path
(chemin sans équivalent)

https://*/path

Correspondance aux URLs HTTPS sur n'importe quel hôte, dont le chemin est "path".

https://mozilla.org/path

https://a.mozilla.org/path

https://something.com/path

http://mozilla.org/path
(schéma sans équivalent)

https://mozilla.org/path/
(chemin sans équivalent)

https://mozilla.org/a
(chemin sans équivalent)

https://mozilla.org/
(chemin sans équivalent)

https://mozilla.org/path?foo=1
(chemin d'accès inégalé grâce à la chaîne d'interrogation URL)

https://*/path/

Correspondance aux URLs HTTPS sur n'importe quel hôte, dont le chemin est "path/".

https://mozilla.org/path/

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

https://something.com/path/

http://mozilla.org/path/
(schéma sans équivalent)

https://mozilla.org/path
(chemin sans équivalent)

https://mozilla.org/a
(chemin sans équivalent)

https://mozilla.org/
(chemin sans équivalent)

https://mozilla.org/path/?foo=1
(chemin d'accès inégalé grâce à la chaîne d'interrogation URL)

https://mozilla.org/*

Correspondance sur toutes les URLs HTTPS uniquement sur "mozilla.org", avec n'importe quel chemin

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
(chemin sans équivalent)

https://mozilla.com/path
(hôte sans équivalent)

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

Correspondance seulement pour cet URL.

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

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

 N'importe quoi d'autre.

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

Correspondance sur toutes les URL HTTPS hébergées sur "mozilla.org", dont le chemin d'accès contient un composant "b" quelque part au milieu. Correspond aux URLs avec les 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 sans équivalent)

https://mozilla.org/a/b/
(chemin sans équivalent)

https://mozilla.org/a/b/c/d/?foo=bar
(chemin d'accès inégalé grâce à la chaîne d'interrogation URL)

file:///blah/*

Correspondance à n'importe quelle URL FILE dont le chemin commence par "blah".

file:///blah/

file:///blah/bleh

 file:///bleh/
(chemin sans équivalent)

Modèles de correspondance invalides

Modèle invalide Raison
resource://path/ schéma non pris en charge.
https://mozilla.org pas de chemin.
https://mozilla.*.org/ "*" dans *hôte* doit être au départ.
https://*zilla.org/ "*" dans *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 un numéro de port.
*://* Chemin vide : il doit être "*://*/*".
file://* Chemin vide : il doit être "file:///*".

Compatibilité des navigateurs

BCD tables only load in the browser