Modèles de correspondance

Un format de correspondance est une URL de la structure suivante, utilisée pour 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 un signe deux-points suivi d'un double slash (://):

  • http
  • https
  • Un caractère générique *, qui ne correspond qu'à http ou https
  • file

Pour savoir comment injecter des scripts de contenu dans des schémas non compatibles, tels que about: et data:, consultez la section Injecter dans des cadres associés.

host: nom d'hôte (www.example.com). Un * placé avant le nom d'hôte pour faire correspondre les sous-domaines (*.example.com) ou simplement un caractère générique *. - Si vous utilisez un caractère générique dans le modèle d'hôte, il doit être le premier ou le seul caractère, et il 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 à toute URL commençant par un schéma autorisé, y compris tout modèle listé sous Modèles valides. Comme il affecte tous les hôtes, les examens du Chrome Web Store pour les extensions qui l'utilisent peuvent prendre plus de temps.
"file:///"
Permet à votre extension de s'exécuter sur des fichiers locaux. Ce modèle nécessite que l'utilisateur accorde manuellement l'accès. Notez que dans ce cas, vous devez utiliser trois barres obliques, et non deux.
URL et adresses IP localhost
Pour faire correspondre n'importe quel port localhost pendant le développement, utilisez http://localhost/*. Pour les adresses IP, spécifiez l'adresse ainsi qu'un caractère générique dans le chemin d'accès, 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 de domaine de premier niveau
Chrome n'est pas compatible avec les expressions régulières pour les domaines de premier niveau (TLD). Spécifiez vos formats de correspondance dans des 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, avec un chemin d'accès commençant par foo. https://example.com/foo/bar.html et https://www.google.com/foo sont des exemples de correspondances.
https://*.google.com/foo*bar
Correspond à n'importe quelle URL utilisant le schéma https sur un hôte google.com, avec un chemin commençant par foo et se terminant par bar. https://www.google.com/foo/baz/bar et https://docs.google.com/foobar sont des exemples de correspondances.
file:///foo*
Correspond à tous les fichiers locaux dont le chemin d'accès commence par foo. file:///foo/bar.html et file:///foo sont des exemples de correspondances.
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. http://127.0.0.1/ et http://127.0.0.1/foo/bar.html sont des exemples de correspondances.
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.