Un patrón de coincidencia es una URL con la siguiente estructura, que se utiliza para especificar un grupo de URLs:
<scheme>://<host>/<path>
esquema: Debe ser una de las siguientes opciones, separadas del resto del patrón con una barra doble (//
):
http
https
- Un comodín
*
, que solo coincide conhttp
ohttps
file
Para obtener información sobre cómo insertar secuencias de comandos de contenido en esquemas no compatibles, como about:
y data:
, consulta Cómo insertar en marcos relacionados.
host: Un nombre de host (www.example.com
). Un *
antes del nombre de host para hacer coincidir subdominios (*.example.com
) o solo un comodín *
.
- Si utilizas un comodín en el patrón de host, este debe ser el primer o único carácter y debe estar seguido por un punto (.
) o una barra diagonal (/
).
path: Es una ruta de URL (/example
). Para los permisos de host, la ruta es obligatoria, pero se ignora. El comodín (/*
) se debe usar de acuerdo con la convención.
Las extensiones usan patrones de coincidencia en una variedad de casos de uso, incluidos los siguientes:
- Inyección de secuencias de comandos de contenido
- Declarar los permisos del host que requieren algunas APIs de Chrome, además de sus propios permisos
- Otorgar acceso a recursos accesibles a través de la Web.
- Permite el envío y la recepción de mensajes con la clave de manifiesto "externally_connectable.matches".
Casos especiales
"<all_urls>"
- Coincide con cualquier URL que comience con un esquema permitido, incluido cualquier patrón que se indique en patrones válidos. Como afecta a todos los hosts, las revisiones de Chrome Web Store de las extensiones que lo usan podrían tardar más.
"file:///"
- Permite que la extensión se ejecute en archivos locales. Este patrón requiere que el usuario otorgue acceso de forma manual. Ten en cuenta que este caso requiere tres barras diagonales, no dos.
- Direcciones IP y URLs de Localhost
- Para que coincida con cualquier puerto de localhost durante el desarrollo, usa
http://localhost/*
. Para las direcciones IP, especifica la dirección más un comodín en la ruta de acceso, como enhttp://127.0.0.1/*
. También puedes usarhttp://*:*/*
para hacer coincidir localhost, direcciones IP y cualquier puerto. - Patrones de coincidencia de dominios de nivel superior
- Chrome no admite patrones de coincidencia para dominios de nivel superior (TLD). Especifica tus patrones de coincidencia dentro de TLD individuales, como en
http://google.es/*
yhttp://google.fr/*
.
Patrones de ejemplo
https://*/*
ohttps://*/
- Busca coincidencias con cualquier URL que use el esquema
https
. https://*/foo*
- Coincide con cualquier URL que use el esquema
https
, en cualquier host, con una ruta que comience confoo
. Algunos ejemplos de coincidencias sonhttps://example.com/foo/bar.html
yhttps://www.google.com/foo
. https://*.google.com/foo*bar
- Coincide con cualquier URL que use el esquema
https
, en un host google.com, con una ruta que comienza confoo
y termina conbar
. Algunos ejemplos de coincidencias sonhttps://www.google.com/foo/baz/bar
yhttps://docs.google.com/foobar
. file:///foo*
- Coincide con cualquier archivo local cuya ruta comience con
foo
. Algunos ejemplos de coincidencias sonfile:///foo/bar.html
yfile:///foo
. http://127.0.0.1/*
ohttp://127.0.0.1/
- Coincide con cualquier URL que utilice el esquema
http
y esté en el host 127.0.0.1. Algunos ejemplos de coincidencias sonhttp://127.0.0.1/
yhttp://127.0.0.1/foo/bar.html
. http://localhost/*
- Coincide con cualquier puerto de localhost.
*://mail.google.com/
o*://mail.google.com/*
- Coincide con cualquier URL que comience con
http://mail.google.com
ohttps://mail.google.com
.