Definindo padrões de correspondência para uma extensão acessar URLs de arquivos

Uma extensão do Microsoft Edge pode solicitar acesso a file URLs. Para habilitar esse recurso, você precisa configurar explicitamente esse acesso. O acesso às file URLs não é automático. Você deve visitar a página de gerenciamento de extensões nos complementos do Microsoft Edge para optar pelo file acesso a cada extensão do Microsoft Edge que solicita acesso a file URLs.

Para a extensão do Microsoft Edge, a permissão de host e a correspondência de padrão de script de conteúdo funcionam da seguinte maneira.

As permissões de host e a correspondência de script de conteúdo são baseadas em um conjunto de URLs definidas por padrões de correspondência. Um padrão de correspondência é essencialmente uma URL que começa com um esquema permitido (http, https, fileou ftp, e que pode conter caracteres '*'. O padrão <all_urls> especial corresponde a qualquer URL que comece com um esquema permitido. Cada padrão de correspondência tem 3 partes:

  • — por exemplo, http ou file ou *

  • _host_ — por exemplo, www.google.com ou *.google.com ou ; *se o esquema for file, não há parte do host.

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

Sintaxe básica

A sintaxe básica:

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

O significado de * depende se está na parte do esquema, host ou caminho. Se o esquema for *, então ele corresponderá a ou httphttps, e não filea , ou ftp. Se o host for apenas *, ele corresponderá a qualquer host. Se o host for *.hostname, ele corresponderá ao host especificado ou a qualquer um dos subdomínios. Na seção de caminho, cada um * corresponde a 0 ou mais caracteres. A tabela a seguir mostra alguns padrões válidos.

Exemplos de padrões válidos

Padrão Função 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 /foo http://example.com/foo/bar.html http://www.google.com/foo
https://*.google.com/foo*bar Corresponde a qualquer URL que use o esquema https, esteja em um google.com host (como www.google.com, docs.google.com, ou google.com), desde que o caminho comece e /foo termine com bar https://www.google.com/foo/baz/bar https://docs.google.com/foobar
http://example.org/foo/bar.html Corresponde à URL especificada http://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 use o http esquema e esteja 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
<all_urls> Corresponde a qualquer URL que use um esquema permitido. (Consulte o início desta seção para obter a lista de esquemas permitidos.) http://example.org/foo/bar.html file:///bar/baz.html

Exemplos de padrões inválidos

Aqui estão alguns exemplos de correspondências de _invalid_ padrões:

Padrão incorreto Por que é ruim
http://www.foo.com Não _path_
http://*foo/bar '*' no host pode ser seguido apenas por um '.' ou '/'
http://foo.*.bar/baz Se '*' estiver no , deve ser o _host_primeiro caractere
http:/bar Separador ausente _scheme_ ('/' deve ser "//")
foo://* Inválido _scheme_

Alguns esquemas não têm suporte em todos os contextos.

Observação

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Google e usadas de acordo com os termos descritos na Licença Creative Commons Atribuição 4.0 Internacional. A página original é encontrada aqui.

Licença Creative Commons Este trabalho está licenciado sob uma Licença Creative Commons Atribuição 4.0 Internacional.

  • Last updated on