Padrões de correspondência

A correspondência entre as permissões do host e o script de conteúdo é baseada em um conjunto de URLs definido por correspondência desenhos. Um padrão de correspondência é essencialmente um URL que começa com um esquema permitido (http, https, file ou ftp e que pode conter "*" caracteres. O padrão especial <all_urls> corresponde qualquer URL que comece com um esquema permitido. Cada padrão de correspondência tem três partes:

  • esquema, por exemplo, http, file ou *

    Observação:o acesso a URLs do file não é automático. O usuário precisa visitar a página de gerenciamento de extensões e ativar o acesso de file para cada extensão que o solicitar.

  • host, por exemplo, www.google.com, *.google.com ou * se o esquema for file, haverá nenhuma parte do host

  • path: por exemplo, /*, /foo* ou /foo/bar. O caminho precisa estar presente em uma permissão de host, mas sempre é tratado como /*.

A sintaxe básica é a seguinte:

&lt;url-pattern&gt; := &lt;scheme&gt;://&lt;host&gt;&lt;path&gt;
&lt;scheme&gt; := '*' | 'http' | 'https' | 'file' | 'ftp' | 'urn'
&lt;host&gt; := '*' | '*.' &lt;any char except '/' and '*'&gt;+
&lt;path&gt; := '/' &lt;any chars&gt;

O significado de "*" depende se ele está na parte esquema, host ou caminho. Se o scheme é *, então corresponde a http ou https e não a file, ftp ou urn. Se o host é apenas *, então corresponde a qualquer host. Se o host for *._hostname_, então ele corresponde host especificado ou qualquer um de seus subdomínios. Na seção path, cada "*" corresponde a 0 ou mais caracteres. A tabela a seguir mostra alguns padrões válidos.

PadrãoO que faz?Exemplos de URLs correspondentes
http://*/*Corresponde a qualquer URL que usa o esquema httphttp://www.google.com/
http://example.org/foo/bar.html
http://*/foo*Corresponde a qualquer URL que usa o esquema http em qualquer host, desde que o caminho comece com /foohttp://example.com/foo/bar.html
http://www.google.com/foo
https://*.google.com/foo*barCorresponde a qualquer URL que usa o esquema https, está em um host google.com (como www.google.com, docs.google.com ou google.com), desde que o caminho comece com /foo e termine com barhttps://www.google.com/foo/baz/bar
https://docs.google.com/foobar
http://example.org/foo/bar.htmlCorresponde ao URL especificadohttp://example.org/foo/bar.html
file:///foo*Corresponde a qualquer arquivo local cujo caminho comece com /foo.file:///foo/bar.html
file:///foo
http://127.0.0.1/*Corresponde a qualquer URL que usa o esquema http e está no host 127.0.0.1http://127.0.0.1/
http://127.0.0.1/foo/bar.html
*://mail.google.com/*Corresponde a qualquer URL que comece com http://mail.google.com ou https://mail.google.com.http://mail.google.com/foo/baz/bar
https://mail.google.com/foobar
urn:*Corresponde a qualquer URL que comece com urn:.urn:uuid:54723bea-c94e-480e-80c8-a69846c3f582
urn:uuid:cfa40aff-07df-45b2-9f95-e023bcf4a6da
<all_urls>Corresponde a qualquer URL que usa um esquema permitido. Consulte o início desta seção para ver a lista de esquemas permitidos.http://example.org/foo/bar.html
file:///bar/baz.html

Confira alguns exemplos de correspondências de padrão inválidas:

Padrão incorretoPor que está ruim
http://www.google.comNenhum caminho
http://*foo/bar"*" no host pode ser seguido apenas por um "." ou "/"
http://foo.*.bar/baz Se "*" estiver no host, ele precisa ser o primeiro caractere
http:/barSeparador de esquema ausente ("/" deveria ser "//")
foo://*Esquema inválido

Alguns esquemas não são compatíveis com todos os contextos.