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 with JavaScript enabled. Enable JavaScript to view data.