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 parties : 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 :

Form Matches
"*" Seulement "http" et "https" and in some browsers also "ws" et "wss".
Un des "http", "https", "ws", "wss", "ftp", "ftps", "data" or "file". Seulement le schéma donné.

hôte

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

Form Matches
"*" 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. 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.

<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" and "file".

Exemples

Pattern Example matches Example non-matches

<all_urls>

correspondre à 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)

*://*/*

Correspondre à 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://*/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/*

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

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/ Anything else.

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.

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

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

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

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

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

file:///blah/*

Correspond à 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

Invalid pattern Reason
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 host 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é du navigateur

schéma

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Wildcard * schemeChrome Support complet OuiEdge Support complet 14Firefox Support complet 48Opera Support complet OuiFirefox Android Support complet 48
* matches ws and wssChrome Aucun support NonEdge ? Firefox Support complet 55Opera Aucun support NonFirefox Android Support complet 55
httpChrome Support complet OuiEdge Support complet 14Firefox Support complet 48Opera Support complet OuiFirefox Android Support complet 48
httpsChrome Support complet OuiEdge Support complet 14Firefox Support complet 48Opera Support complet OuiFirefox Android Support complet 48
wsChrome Aucun support NonEdge ? Firefox Support complet 55Opera Aucun support NonFirefox Android Support complet 55
wssChrome Aucun support NonEdge ? Firefox Support complet 55Opera Aucun support NonFirefox Android Support complet 55
ftpChrome Support complet OuiEdge Support complet 14Firefox Support complet 48Opera Support complet OuiFirefox Android Support complet 48
ftpsChrome Aucun support NonEdge Aucun support NonFirefox Aucun support Non
Notes
Aucun support Non
Notes
Notes See bug 1463440
Opera Aucun support NonFirefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes See bug 1463440
fileChrome Support complet OuiEdge Support complet 14Firefox Support complet 48Opera Support complet OuiFirefox Android Support complet 48
dataChrome Aucun support NonEdge ? Firefox Support partiel 48
Notes
Support partiel 48
Notes
Notes Doesn’t support injection of content scripts or stylesheets.
Opera Aucun support NonFirefox Android Support partiel 48
Notes
Support partiel 48
Notes
Notes Doesn’t support injection of content scripts or stylesheets.

Légende

Support complet  
Support complet
Support partiel  
Support partiel
Aucun support  
Aucun support
Compatibilité inconnue  
Compatibilité inconnue
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : hellosct1, Watilin
Dernière mise à jour par : hellosct1,