Modèles de correspondance

Un format de correspondance est une URL présentant la structure suivante, qui permet de spécifier un groupe d'URL:

<scheme>://<host>/<path>

scheme: doit être l'un des éléments suivants, séparés du reste du modèle à l'aide d'une double barre oblique (//):

  • 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: 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 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 d'accès 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 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 en utilisant le schéma https, sur n'importe quel hôte, dont le chemin d'accès 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 en utilisant le schéma https, sur un hôte google.com, dont le chemin d'accès commence par foo et se termine 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. 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.