Modèles de correspondance

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 ou https
  • 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:

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 dans http://127.0.0.1/*. Vous pouvez également utiliser http://*:*/* 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/* et http://google.fr/*.

Exemples de formats

https://*/* ou https://*/
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 par foo. Exemples de correspondances : https://example.com/foo/bar.html et https://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 par foo et se termine par bar. Exemples de correspondances : https://www.google.com/foo/baz/bar et https://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 et file:///foo.
http://127.0.0.1/* ou http://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/ et http://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 ou https://mail.google.com.