Un format de correspondance est une URL ayant la structure suivante, qui permet de spécifier un groupe d'URL:
<scheme>://<host>/<path>
scheme: doit correspondre à l'un des éléments suivants, séparés du reste du modèle par une double barre oblique (//
):
http
https
- Un caractère générique
*
, correspondant uniquement àhttp
ouhttps
file
Pour en savoir plus sur l'injection de scripts de contenu dans des schémas non compatibles, tels que about:
et data:
, consultez Injecter dans des frames associés.
host: un nom d'hôte (www.example.com
), un *
avant le nom d'hôte pour correspondre aux sous-domaines (*.example.com
), ou simplement un *
générique.
- Si vous utilisez un caractère générique dans le format d'hôte, il doit s'agir du premier ou du seul caractère, et doit être suivi d'un point (.
) ou d'une barre oblique (/
).
path: chemin d'URL (/example
). Pour les autorisations d'hôte, le chemin est obligatoire, mais ignoré. Le caractère générique (/*
) doit être utilisé par convention.
Les extensions utilisent des modèles de correspondance dans divers cas d'utilisation, y compris les suivants:
- Injecter un script de contenu
- Déclarer des autorisations d'hôte que certaines API Chrome nécessitent en plus de leurs propres autorisations.
- Accorder l'accès aux ressources accessibles sur le Web
- Autoriser l'envoi et la réception de messages à l'aide de la clé du fichier manifeste "externally_connectable.matches"
Cas particuliers
"<all_urls>"
- Correspond à n'importe quelle URL commençant par un schéma autorisé, y compris tout format répertorié sous formats valides. Étant donné qu'il affecte tous les hôtes, les examens du Chrome Web Store concernant les extensions qui l'utilisent peuvent prendre plus de temps.
"file:///"
- Autorise l'exécution de l'extension sur des fichiers locaux. Ce schéma nécessite que l'utilisateur accorde l'accès manuellement. Notez que ce cas nécessite trois barres obliques, et non deux.
- URL et adresses IP de l'hôte local
- Pour faire correspondre un port localhost pendant le développement, utilisez
http://localhost/*
. Pour les adresses IP, spécifiez l'adresse et un caractère générique dans le chemin, comme danshttp://127.0.0.1/*
. Vous pouvez également utiliserhttp://*:*/*
pour faire correspondre localhost, des adresses IP et n'importe quel port. - Modèles de correspondance des domaines de premier niveau
- Chrome n'accepte pas les formats de correspondance pour les domaines de premier niveau. Spécifiez vos modèles de correspondance au sein de domaines de premier niveau individuels, comme dans
http://google.es/*
ethttp://google.fr/*
.
Exemples de formats
https://*/*
ouhttps://*/
- Correspond à n'importe quelle URL utilisant le schéma
https
. https://*/foo*
- Correspond à n'importe quelle URL utilisant le schéma
https
, sur n'importe quel hôte, dont le chemin commence parfoo
. Exemples de correspondances :https://example.com/foo/bar.html
ethttps://www.google.com/foo
. https://*.google.com/foo*bar
- Correspond à n'importe quelle URL utilisant le schéma
https
, sur un hôte google.com, dont le chemin commence parfoo
et se termine parbar
. Exemples de correspondances :https://www.google.com/foo/baz/bar
ethttps://docs.google.com/foobar
. file:///foo*
- Correspond à tout fichier local dont le chemin d'accès commence par
foo
. Exemples de correspondances :file:///foo/bar.html
etfile:///foo
. http://127.0.0.1/*
ouhttp://127.0.0.1/
- Correspond à n'importe quelle URL utilisant le schéma
http
et se trouvant sur l'hôte 127.0.0.1. Exemples de correspondances :http://127.0.0.1/
ethttp://127.0.0.1/foo/bar.html
. http://localhost/*
- Correspond à n'importe quel port localhost.
*://mail.google.com/
ou*://mail.google.com/*
- Correspond à n'importe quelle URL commençant par
http://mail.google.com
ouhttps://mail.google.com
.