path: root/files/fr/mozilla/add-ons/webextensions/match_patterns/index.html

---
title: Motifs (Match patterns)
slug: Mozilla/Add-ons/WebExtensions/Match_patterns
tags:
  - Match pattern
  - Modèle de correspondance
  - WebExtensions
translation_of: Mozilla/Add-ons/WebExtensions/Match_patterns
---
<div>{{AddonSidebar}}</div>

<p>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 <a href="/fr/Add-ons/WebExtensions/Content_scripts">content scripts</a>, et pour spécifier les URL à ajouter aux auditeurs <code><a href="/fr/Add-ons/WebExtensions/API/webRequest">webRequest</a></code>.</p>

<p>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é <code><a href="/fr/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a></code> dans manifest.json.</p>

<h2 id="Structure_du_modèle_de_correspondance">Structure du modèle de correspondance</h2>

<div class="note">
<p><strong>Note:</strong> Certains navigateurs ne prennent pas en charge certains schémas.<br>
 Consultez le <a href="#Browser_compatibility">tableau de compatibilité du navigateur</a> pour plus de détails.</p>
</div>

<p>Tous les modèles de correspondance sont spécifiés comme des chaînes. Outre le motif spécial « <a href="/fr/Add-ons/WebExtensions/Match_patterns#%3Call_urls%3E">&lt;all_urls&gt;</a> », les modèles de correspondance se composent de trois partie : <em>schéma</em>, l’hôte, et le <em>chemin d’accès.</em> Le schéma et l’hôte sont séparés par « :// ».</p>

<pre>&lt;scheme&gt;://&lt;host&gt;&lt;path&gt;</pre>

<h3 id="schéma">schéma</h3>

<p>Le composant du <em>schéma</em> peut prendre l’une des deux formes suivantes :</p>

<table class="fullwidth-table standard-table">
 <thead>
  <tr>
   <th scope="col" style="width: 50%;">Valeur</th>
   <th scope="col">Correspondances</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><code>*</code></td>
   <td>Seulement "http" et "https" et dans certains navigateurs <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebSockets_API">"ws" et "wss"</a> aussi.</td>
  </tr>
  <tr>
   <td>Une parmi <code>http</code>, <code>https</code>, <code>ws</code>, <code>wss</code>, <code>ftp</code>, <code>ftps</code>, <code>data</code> ou <code>file</code>.</td>
   <td>Seulement le schéma donné.</td>
  </tr>
 </tbody>
</table>

<h3 id="hôte">hôte</h3>

<p>Le composant <em>hôte</em> peut prendre l'une des trois formes suivantes :</p>

<table class="fullwidth-table standard-table">
 <thead>
  <tr>
   <th scope="col" style="width: 50%;">Valeur</th>
   <th scope="col">Correspondances</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><code>*</code></td>
   <td>Tout hôte</td>
  </tr>
  <tr>
   <td><code>*.</code> Suivi d’une partie du nom d’hôte</td>
   <td>L’hôte donné et l’un de ses sous-domaines</td>
  </tr>
  <tr>
   <td>Un nom d’hôte complet, sans caractères génériques</td>
   <td>Seul l’hôte donné</td>
  </tr>
 </tbody>
</table>

<p>L’<em>hôte</em> ne doit pas inclure un numéro de port.</p>

<p>L’<em>hôte</em> est facultatif seulement si le <em>schéma</em> est un « fichier ».</p>

<p>Notez que le caractère générique ne peut apparaître qu’au début.</p>

<h3 id="chemin">chemin</h3>

<p>Le composant du chemin d’accès doit commencer par un <code>/</code>.</p>

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



<p>La valeur du <em>chemin</em> matches correspond à la chaîne de caractères qui est le chemin plus la  <a href="https://en.wikipedia.org/wiki/Query_string">chaine de requête URL</a>. Ceci inclut le signe <code>?</code> 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 <code>foo.bar</code>, alors vous devez utiliser un tableau de Match Patterns comme <code>['*://*/*foo.bar', '*://*/*foo.bar?*']</code>. Le <code>?*</code> est nécessaire, plutôt que juste la <code>bar*</code>, afin d'ancrer la fin <code>*</code> comme s'appliquant à la chaîne de requête URL et non à une partie du chemin URL.</p>

<p>Ni l'<a href="https://en.wikipedia.org/wiki/Fragment_identifier">identificateur de fragment d'URL</a>, ni le <code>#</code> qui le précède, ne sont considérés comme faisant partie du <em>chemin</em>.</p>

<div class="blockIndicator note">
<p><strong>Note</strong>: 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 : <em>"http://localhost:1234/*" </em>fait que le motif de match est ignoré. Cependant, "<em>http://localhost:1234</em>" correspondra avec "<em>http://localhost/*</em>"</p>
</div>

<h3 id="&lt;all_urls>">&lt;all_urls&gt;</h3>

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

<h2 id="Exemples">Exemples</h2>

<table class="fullwidth-table standard-table">
 <thead>
  <tr>
   <th scope="col" style="width: 33%;">Modèle</th>
   <th scope="col" style="width: 33%;">Exemples de correspondances</th>
   <th scope="col" style="width: 33%;">Exemples de non-correspondances</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>
    <p><code>&lt;all_urls&gt;</code></p>

    <p>Correspondance à toutes les URL</p>
   </td>
   <td>
    <p><code>http://example.org/</code></p>

    <p><code>https://a.org/some/path/</code></p>

    <p><code>ws://sockets.somewhere.org/</code></p>

    <p><code>wss://ws.example.com/stuff/</code></p>

    <p><code>ftp://files.somewhere.org/</code></p>

    <p><code>ftps://files.somewhere.org/</code></p>
   </td>
   <td>
    <p><code>resource://a/b/c/</code><br>
     (schéma sans équivalent)</p>
   </td>
  </tr>
  <tr>
   <td>
    <p><code>*://*/*</code></p>

    <p>Correspondance à toutes les URLs HTTP, HTTPS et WebSocket</p>
   </td>
   <td>
    <p><code>http://example.org/</code></p>

    <p><code>https://a.org/some/path/</code></p>

    <p><code>ws://sockets.somewhere.org/</code></p>

    <p><code>wss://ws.example.com/stuff/</code></p>
   </td>
   <td>
    <p><code>ftp://ftp.example.org/</code><br>
     (schéma sans équivalent)</p>

    <p><code>ftps://ftp.example.org/</code><br>
     (schéma sans équivalent)</p>

    <p><code>file:///a/</code><br>
     (schéma sans équivalent)</p>
   </td>
  </tr>
  <tr>
   <td>
    <p><code>*://*.mozilla.org/*</code></p>

    <p>Correspondance à toutes les URLs HTTP, HTTPS et WebSocket URLs qui sont hébergés sur "mozilla.org" ou l’un de ses sous-domaines.</p>
   </td>
   <td>
    <p><code>http://mozilla.org/</code></p>

    <p><code>https://mozilla.org/</code></p>

    <p><code>http://a.mozilla.org/</code></p>

    <p><code>http://a.b.mozilla.org/</code></p>

    <p><code>https://b.mozilla.org/path/</code></p>

    <p><code>ws://ws.mozilla.org/</code></p>

    <p><code>wss://secure.mozilla.org/something</code></p>
   </td>
   <td>
    <p><code>ftp://mozilla.org/</code><br>
     (schéma sans équivalent)</p>

    <p><code>http://mozilla.com/</code><br>
     (hôte sans équivalent)</p>

    <p><code>http://firefox.org/</code><br>
     (hôte sans équivalent)</p>
   </td>
  </tr>
  <tr>
   <td>
    <p><code>*://mozilla.org/</code></p>

    <p>Correspondance à toutes les URLs HTTP, HTTPS and WebSocket qui sont hébergés exactement chez "mozilla.org/"</p>
   </td>
   <td>
    <p><code>http://mozilla.org/</code></p>

    <p><code>https://mozilla.org/</code></p>

    <p><code>ws://mozilla.org/</code></p>

    <p><code>wss://mozilla.org/</code></p>
   </td>
   <td>
    <p><code>ftp://mozilla.org/</code><br>
     (schéma sans équivalent)</p>

    <p><code>http://a.mozilla.org/</code><br>
     (hôte sans équivalent)</p>

    <p><code>http://mozilla.org/a</code><br>
     (chemin sans équivalent)</p>
   </td>
  </tr>
  <tr>
   <td>
    <p><code>ftp://mozilla.org/</code></p>

    <p>Correspondance seulement à "ftp://mozilla.org/".</p>
   </td>
   <td><code>ftp://mozilla.org</code></td>
   <td>
    <p><code>http://mozilla.org/</code><br>
     (schéma sans équivalent)</p>

    <p><code>ftp://sub.mozilla.org/</code><br>
     (hôte sans équivalent)</p>

    <p><code>ftp://mozilla.org/path</code><br>
     (chemin sans équivalent)</p>
   </td>
  </tr>
  <tr>
   <td>
    <p><code>https://*/path</code></p>

    <p>Correspondance aux URLs  HTTPS sur n'importe quel hôte, dont le chemin est "path".</p>
   </td>
   <td>
    <p><code>https://mozilla.org/path</code></p>

    <p><code>https://a.mozilla.org/path</code></p>

    <p><code>https://something.com/path</code></p>
   </td>
   <td>
    <p><code>http://mozilla.org/path</code><br>
     (schéma sans équivalent)</p>

    <p><code>https://mozilla.org/path/</code><br>
     (chemin sans équivalent)</p>

    <p><code>https://mozilla.org/a</code><br>
     (chemin sans équivalent)</p>

    <p><code>https://mozilla.org/</code><br>
     (chemin sans équivalent)</p>

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

    <p>Correspondance aux URLs HTTPS sur n’importe quel hôte, dont le chemin est "path/".</p>
   </td>
   <td>
    <p><code>https://mozilla.org/path/</code></p>

    <p><code>https://a.mozilla.org/path/</code></p>

    <p><code>https://something.com/path</code>/</p>
   </td>
   <td>
    <p><code>http://mozilla.org/path/</code><br>
     (schéma sans équivalent)</p>

    <p><code>https://mozilla.org/path</code><br>
     (chemin sans équivalent)</p>

    <p><code>https://mozilla.org/a</code><br>
     (chemin sans équivalent)</p>

    <p><code>https://mozilla.org/</code><br>
     (chemin sans équivalent)</p>

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

    <p>Correspondance sur toutes les URLs HTTPS uniquement sur "mozilla.org", avec n’importe quel chemin</p>
   </td>
   <td>
    <p><code>https://mozilla.org/</code></p>

    <p><code>https://mozilla.org/path</code></p>

    <p><code>https://mozilla.org/another</code></p>

    <p><code>https://mozilla.org/path/to/doc</code></p>

    <p><code>https://mozilla.org/path/to/doc?foo=1</code></p>
   </td>
   <td>
    <p><code>http://mozilla.org/path</code><br>
     (chemin sans équivalent)</p>

    <p><code>https://mozilla.com/path</code><br>
     (hôte sans équivalent)</p>
   </td>
  </tr>
  <tr>
   <td>
    <p><code>https://mozilla.org/a/b/c/</code></p>

    <p>Correspondance seulement pour cet URL.</p>
   </td>
   <td>
    <p><code>https://mozilla.org/a/b/c/</code></p>

    <p><code>https://mozilla.org/a/b/c/#section1</code></p>
   </td>
   <td>N'importe quoi d'autre.</td>
  </tr>
  <tr>
   <td>
    <p><code>https://mozilla.org/*/b/*/</code></p>

    <p>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 <code>/</code>.</p>
   </td>
   <td>
    <p><code>https://mozilla.org/a/b/c/</code></p>

    <p><code>https://mozilla.org/d/b/f/</code></p>

    <p><code>https://mozilla.org/a/b/c/d/</code></p>

    <p><code>https://mozilla.org/a/b/c/d/#section1</code></p>

    <p><code>https://mozilla.org/a/b/c/d/?foo=/</code></p>

    <p><code>https://mozilla.org/a?foo=21314&amp;bar=/b/&amp;extra=c/</code></p>
   </td>
   <td>
    <p><code>https://mozilla.org/b/*/</code><br>
     (chemin sans équivalent)</p>

    <p><code>https://mozilla.org/a/b/</code><br>
     (chemin sans équivalent)</p>

    <p><code>https://mozilla.org/a/b/c/d/?foo=bar</code><br>
     (chemin d'accès inégalé grâce à la chaîne d'interrogation URL)</p>
   </td>
  </tr>
  <tr>
   <td>
    <p><code>file:///blah/*</code></p>

    <p>Correspondance à n’importe quelle URL FILE dont le chemin commence par "blah".</p>
   </td>
   <td>
    <p><code>file:///blah/</code></p>

    <p><code>file:///blah/bleh</code></p>
   </td>
   <td><code>file:///bleh/</code><br>
    (chemin sans équivalent)</td>
  </tr>
 </tbody>
</table>

<h3 id="Modèles_de_correspondance_invalides">Modèles de correspondance invalides</h3>

<table class="fullwidth-table standard-table">
 <thead>
  <tr>
   <th scope="col">Modèle invalide</th>
   <th scope="col">Raison</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><code>resource://path/</code></td>
   <td>schéma non pris en charge.</td>
  </tr>
  <tr>
   <td><code>https://mozilla.org</code></td>
   <td>pas de chemin.</td>
  </tr>
  <tr>
   <td><code>https://mozilla.*.org/</code></td>
   <td>"*" dans <em>hôte</em> doit être au départ.</td>
  </tr>
  <tr>
   <td><code>https://*zilla.org/</code></td>
   <td>"*" dans <em>hôte</em> doit être le seul caractère ou être suivi de « . ».</td>
  </tr>
  <tr>
   <td><code>http*://mozilla.org/</code></td>
   <td>"*" dans le schéma doit être le seul caractère.</td>
  </tr>
  <tr>
   <td><code>https://mozilla.org:80/</code></td>
   <td>L’hôte ne doit pas inclure un numéro de port.</td>
  </tr>
  <tr>
   <td><code>*://*</code></td>
   <td>Chemin vide : il doit être "<code>*://*/*</code>".</td>
  </tr>
  <tr>
   <td><code>file://*</code></td>
   <td>Chemin vide : il doit être "<code>file:///*</code>".</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<h3 id="schéma_2">schéma</h3>



<p>{{Compat("webextensions.match_patterns.scheme",10)}}</p>