Patrones de coincidencia

La coincidencia de permisos de host y secuencia de comandos de contenido se basa en un conjunto de URLs definidas por patrones de coincidencia. Un patrón de coincidencia es, en esencia, una URL que comienza con un esquema permitido (http, https, file o ftp, y que puede contener caracteres "*". El patrón especial <all_urls> coincide con cualquier URL que comience con un esquema permitido. Cada patrón de concordancia tiene 3 partes:

  • esquema: por ejemplo, http, file o *

    Nota: El acceso a las URLs de file no es automático. El usuario debe visitar la página de administración de extensiones y habilitar el acceso a file para cada extensión que lo solicite.
  • host: Por ejemplo, www.google.com, *.google.com o *. Si el esquema es file, no hay parte de host.

  • ruta: Por ejemplo, /*, /foo* o /foo/bar. La ruta de acceso debe estar presente en un permiso de host, pero siempre se considera como /*.

Esta es la sintaxis básica:

&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;

El significado de "*" depende de si está en la parte del esquema, del host o de la ruta. Si el esquema es *, entonces coincide con http o https, y no con file, ftp o urn. Si el host es solo *, entonces coincide con cualquier host. Si el host es *._hostname_, entonces coincide con el host especificado o con cualquiera de sus subdominios. En la sección path, cada "*" coincide con 0 o más caracteres. En la siguiente tabla, se muestran algunos patrones válidos.

PatrónQué haceEjemplos de URLs coincidentes
http://*/*Coincide con cualquier URL que utilice el esquema http.http://www.google.com/
http://example.org/foo/bar.html
http://*/foo*Coincide con cualquier URL que use el esquema http, en cualquier host, siempre y cuando la ruta comience con /foo.http://example.com/foo/bar.html
http://www.google.com/foo
https://*.google.com/foo*barCoincide con cualquier URL que utilice el esquema https y esté en un host google.com (como www.google.com, docs.google.com o google.com), siempre y cuando la ruta comience con /foo y termine con bar.https://www.google.com/foo/baz/bar
https://docs.google.com/foobar
http://example.org/foo/bar.htmlCoincide con la URL especificadahttp://example.org/foo/bar.html
file:///foo*Coincide con cualquier archivo local cuya ruta comience con /foo.file:///foo/bar.html
file:///foo
http://127.0.0.1/*Coincide con cualquier URL que utilice el esquema http y esté en el host 127.0.0.1.http://127.0.0.1/
http://127.0.0.1/foo/bar.html
*://mail.google.com/*Coincide con cualquier URL que comience con http://mail.google.com o https://mail.google.com.http://mail.google.com/foo/baz/bar
https://mail.google.com/foobar
urn:*Coincide con cualquier URL que comience con urn:.urn:uuid:54723bea-c94e-480e-80c8-a69846c3f582
urn:uuid:cfa40aff-07df-45b2-9f95-e023bcf4a6da
<all_urls>Coincide con cualquier URL que use un esquema permitido. (consulta el comienzo de esta sección para ver la lista de esquemas permitidos).http://example.org/foo/bar.html
file:///bar/baz.html

Estos son algunos ejemplos de coincidencias de patrones no válidas:

Patrón incorrectoPor qué es malo
http://www.google.comSin ruta
http://*foo/barEl símbolo "*" en el host solo puede estar seguido de "." o "/".
http://foo.*.bar/baz Si “*” está en el host, debe ser el primer carácter.
http:/barFalta el separador de esquema ("/" debería ser "//").
foo://*Esquema no válido

Algunos esquemas no son compatibles con todos los contextos.