Définition de modèles de correspondance pour une extension pour accéder aux URL de fichier

Un module complémentaire Microsoft Edge (extension) peut demander l’accès aux file URL. Pour activer cette fonctionnalité, vous devez configurer explicitement cet accès. L’accès aux file URL n’est pas automatique. Vous devez visiter la page gestion des extensions sur le site web des modules complémentaires Microsoft Edge pour choisir file l’accès à chaque extension Microsoft Edge qui demande l’accès aux file URL.

Pour les modules complémentaires Microsoft Edge (extensions), l’autorisation d’hôte et le modèle de script de contenu fonctionnent comme suit.

Les autorisations d’hôte et la correspondance de script de contenu sont basées sur un ensemble d’URL définies par des modèles de correspondance. Un modèle de correspondance est essentiellement une URL qui commence par un schéma autorisé (http, , httpsfileou ftp, et qui peut contenir des caractères «* ». Le modèle <all_urls> spécial correspond à toute URL qui commence par un schéma autorisé. Chaque modèle de correspondance comporte 3 parties :

  • schéma — par exemple, http ou file ou *

  • _host_— par exemple, www.google.com ou ou **.google.com ; si le schéma est un fichier, il n’y a pas de composant hôte.

  • _path_ — par exemple, /*, /foo*ou /foo/bar. Le chemin d’accès doit être présent dans une autorisation d’hôte, mais est toujours traité comme /*.

Syntaxe de base

Syntaxe de base :

<url-pattern> := <scheme>://<host><path>
<scheme> := '*' | 'http' | 'https' | 'file' | 'ftp'
<host> := '*' | '*.' <any char except '/' and '*'>+
<path> := '/' <any chars>

La signification de * varie selon qu’il se trouve dans le schéma, l’hôte ou la partie du chemin d’accès. Si le schéma est *, il correspond à http ou , httpset non à file, ou ftp. Si l’hôte est simplement *, il correspond à n’importe quel hôte. Si l’hôte est *.hostname, il correspond à l’hôte spécifié ou à l’un des sous-domaines. Dans la section chemin d’accès, chaque * correspond à 0 caractères ou plus. Le tableau suivant présente des modèles valides.

Exemples de modèles valides

Modèle Ce qu'il fait Exemples d’URL correspondantes
http://*/* Correspond à toute URL qui utilise le schéma HTTP http://www.google.com http://example.org/foo/bar.html
http://*/foo* Correspond à toute URL qui utilise le schéma http, sur n’importe quel hôte, tant que le chemin commence par /foo http://example.com/foo/bar.html http://www.google.com/foo
https://*.google.com/foo*bar Correspond à toute URL qui utilise le schéma https, se trouve sur un google.com hôte (par www.google.comexemple, , docs.google.comou google.com), tant que le chemin commence par /foo et se termine par bar https://www.google.com/foo/baz/bar https://docs.google.com/foobar
http://example.org/foo/bar.html Correspond à l’URL spécifiée http://example.org/foo/bar.html
file:///foo* Correspond à n’importe quel fichier local dont le chemin commence par /foo file:///foo/bar.html file:///foo
http://127.0.0.1/* Correspond à toute URL qui utilise le http schéma et qui se trouve sur l’hôte 127.0.0.1 http://127.0.0.1 http://127.0.0.1/foo/bar.html
*://mail.google.com/* Correspond à toute URL qui commence par http://mail.google.com ou https://mail.google.com. http://mail.google.com/foo/baz/bar https://mail.google.com/foobar
<all_urls> Correspond à toute URL qui utilise un schéma autorisé. (Consultez le début de cette section pour obtenir la liste des schémas autorisés.) http://example.org/foo/bar.html file:///bar/baz.html

Exemples de modèles non valides

Voici quelques exemples de correspondances de _invalid_ modèle :

Modèle incorrect Pourquoi c’est mauvais
http://www.foo.com Non _path_
http://*foo/bar '*' dans l’hôte ne peut être suivi que d’un '.' ou '/'
http://foo.*.bar/baz Si '*' se trouve dans , _host_il doit s’agir du premier caractère
http:/bar Séparateur manquant _scheme_ ('/' doit être « // »)
foo://* Non valide _scheme_

Certains schémas ne sont pas pris en charge dans tous les contextes.

Remarque

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Google et utilisées conformément aux termes décrits dans la licence internationale Creative Commons Attribution 4.0. La page d’origine se trouve ici.

Licence Creative Commons Cette œuvre est concédée sous licence creative commons attribution 4.0 international.