Patrones de coincidencia

Un patrón de coincidencia es una URL con la siguiente estructura, que se usa para especificar un grupo de URLs:

<scheme>://<host>/<path>

esquema: Debe ser una de las siguientes opciones, separadas del resto del patrón con dos puntos seguidos de una barra doble (://):

• http
• https
• Un comodín *, que solo coincide con http o https
• 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 usas un comodín en el patrón de host, debe ser el primer o único carácter, y debe estar seguido de 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. Debido a que afecta a todos los hosts, las opiniones de Chrome Web Store para las extensiones que lo usan pueden 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.

URLs y direcciones IP 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 en http://127.0.0.1/*. También puedes usar http://*:*/* 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/* y http://google.fr/*.

Patrones de ejemplo

https://*/* o https://*/

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 que comience con foo. Algunos ejemplos de coincidencias son https://example.com/foo/bar.html y https://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 con foo y termina con bar. Algunos ejemplos de coincidencias son https://www.google.com/foo/baz/bar y https://docs.google.com/foobar.

file:///foo*

Coincide con cualquier archivo local cuya ruta comience con foo. Algunos ejemplos de coincidencias son file:///foo/bar.html y file:///foo.

http://127.0.0.1/* o http://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 son http://127.0.0.1/ y http://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 o https://mail.google.com.