Un patrón de coincidencia es una URL con la siguiente estructura, que se usa para especificar un grupo de URLs:
<scheme>://<host>/<path>
scheme: Debe ser uno de los siguientes, separado del resto del patrón mediante 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 secuencias de comandos de contenido en marcos relacionados.
host: Un nombre de host (www.example.com
). Es un *
antes del nombre de host para que coincida con los subdominios (*.example.com
) o solo un comodín *
.
- Si usas un comodín en el patrón de host, debe ser el primer o el único carácter, y debe estar seguido de un punto (.
) o una barra diagonal (/
).
path: Es una ruta de URL (/example
). Para los permisos del host, la ruta es obligatoria, pero se ignora. El comodín (/*
) se debe usar por convención.
Las extensiones utilizan patrones de coincidencia en una variedad de casos de uso, incluidos los siguientes:
- Incorporació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 los recursos con acceso a través de la Web
- Permitir el envío y la recepción de mensajes mediante la clave de manifiesto "externally_connectable.matches"
Casos especiales
"<all_urls>"
- Coincide con cualquier URL que comience con un esquema permitido, incluidos los patrones enumerados en patrones válidos. Dado que afecta a todos los hosts, las revisiones de Chrome Web Store de las extensiones que la usan pueden tardar más.
"file:///"
- Permite que tu 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, no dos.
- URLs y direcciones IP de Localhost
- Para hacer coincidir cualquier puerto 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 el host local, las 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://*/
- Coincide 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 de acceso que comience confoo
. Algunos ejemplos de coincidencias incluyenhttps://example.com/foo/bar.html
yhttps://www.google.com/foo
. https://*.google.com/foo*bar
- Coincide con cualquier URL que utilice el esquema
https
, en un host de google.com, con una ruta de acceso que comience confoo
y termine enbar
. Algunos ejemplos de coincidencias incluyenhttps://www.google.com/foo/baz/bar
yhttps://docs.google.com/foobar
. file:///foo*
- Coincide con cualquier archivo local cuya ruta de acceso comience con
foo
. Algunos ejemplos de coincidencias incluyenfile:///foo/bar.html
yfile:///foo
. http://127.0.0.1/*
ohttp://127.0.0.1/
- Coincide con cualquier URL que use el esquema
http
y esté en el host 127.0.0.1. Algunos ejemplos de coincidencias incluyenhttp://127.0.0.1/
yhttp://127.0.0.1/foo/bar.html
. http://localhost/*
- Coincide con cualquier puerto localhost.
*://mail.google.com/
o*://mail.google.com/*
- Coincide con cualquier URL que comience con
http://mail.google.com
ohttps://mail.google.com
.