Padrões de correspondência

As permissões de host e a correspondência de scripts de conteúdo são baseadas em um conjunto de URLs definidos por padrões de correspondência. Um padrão de correspondência é essencialmente um URL que começa com um esquema permitido (http, https, file ou ftp) e pode conter caracteres "*". O padrão especial <all_urls> corresponde a 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 aos URLs file não é automático. O usuário precisa acessar a página de gerenciamento de extensões e ativar o acesso file para cada extensão que o solicita.

  • host: por exemplo, www.google.com, *.google.com ou *. Se o esquema for file, não haverá parte 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 de estar na parte esquema, host ou caminho. Se o esquema for *, ele vai corresponder a http ou https, e não file, ftp ou urn. Se o host for apenas *, ele vai corresponder a qualquer host. Se o host for *._hostname_, ele vai corresponder ao host especificado ou a qualquer um dos subdomínios dele. Na seção path, cada "*" corresponde a zero 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 http.http://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 e 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 bar.https://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 /foofile:///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.1.http://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 conferir 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 isso é ruim
http://www.google.comNenhum caminho
http://*foo/barO caractere "*" 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 ("/" precisa ser "//")
foo://*Esquema inválido

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