From 3cf9bd8b9901006085d4e0f353b0d3b6b8f69d93 Mon Sep 17 00:00:00 2001 From: julieng Date: Mon, 15 Nov 2021 21:45:15 +0100 Subject: convert content to md --- .../add-ons/webextensions/match_patterns/index.md | 710 +++++++++------------ 1 file changed, 319 insertions(+), 391 deletions(-) (limited to 'files/fr/mozilla/add-ons/webextensions/match_patterns') diff --git a/files/fr/mozilla/add-ons/webextensions/match_patterns/index.md b/files/fr/mozilla/add-ons/webextensions/match_patterns/index.md index 682f842662..fee3d3d5d8 100644 --- a/files/fr/mozilla/add-ons/webextensions/match_patterns/index.md +++ b/files/fr/mozilla/add-ons/webextensions/match_patterns/index.md @@ -7,430 +7,358 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/Match_patterns --- -
{{AddonSidebar}}
+{{AddonSidebar}} -

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 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](/fr/Add-ons/WebExtensions/Content_scripts), et pour spécifier les URL à ajouter aux auditeurs [`webRequest`](/fr/Add-ons/WebExtensions/API/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.

+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`](/fr/Add-ons/WebExtensions/manifest.json/content_scripts) dans manifest.json. -

Structure du modèle de correspondance

+## 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.

-
+> **Note :** Certains navigateurs ne prennent pas en charge certains schémas. +> Consultez le [tableau de compatibilité du navigateur](#Browser_compatibility) 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 « :// ».

+Tous les modèles de correspondance sont spécifiés comme des chaînes. Outre le motif spécial « [\](/fr/Add-ons/WebExtensions/Match_patterns#%3Call_urls%3E) », 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

+### schéma -

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

+Le composant du _schéma_ peut prendre l’une des deux formes suivantes : - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + +
ValeurCorrespondances
*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é.
ValeurCorrespondances
* + 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

+### hôte -

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

+Le composant _hôte_ peut prendre l'une des trois formes suivantes : - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
ValeurCorrespondances
*Tout hôte
*. Suivi d’une partie du nom d’hôteL’hôte donné et l’un de ses sous-domaines
Un nom d’hôte complet, sans caractères génériquesSeul l’hôte donné
ValeurCorrespondances
*Tout hôte
*. Suivi d’une partie du nom d’hôteL’hôte donné et l’un de ses sous-domaines
Un nom d’hôte complet, sans caractères génériquesSeul l’hôte donné
-

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

+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 ».

+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.

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

chemin

+### chemin -

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

+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.

+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](https://en.wikipedia.org/wiki/Query_string). 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](https://en.wikipedia.org/wiki/Fragment_identifier), ni le `#` qui le précède, ne sont considérés comme faisant partie du _chemin_. -

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.

+> **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/\*\*" -

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/*"

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

<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èleExemples de correspondancesExemples 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

+## Exemples - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Modèle invalideRaison
resource://path/schéma non pris en charge.
https://mozilla.orgpas 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:///*".
ModèleExemples de correspondancesExemples 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)
-

Compatibilité des navigateurs

+### Modèles de correspondance invalides -

schéma

+| 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 +### schéma -

{{Compat("webextensions.match_patterns.scheme",10)}}

+{{Compat("webextensions.match_patterns.scheme",10)}} -- cgit v1.2.3-54-g00ecf