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>

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 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 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:

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 en http://127.0.0.1/*. También puedes usar http://*:*/* 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/* 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 de acceso que comience con foo. Algunos ejemplos de coincidencias incluyen https://example.com/foo/bar.html y https://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 con foo y termine en bar. Algunos ejemplos de coincidencias incluyen https://www.google.com/foo/baz/bar y https://docs.google.com/foobar.
file:///foo*
Coincide con cualquier archivo local cuya ruta de acceso comience con foo. Algunos ejemplos de coincidencias incluyen 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 incluyen http://127.0.0.1/ y http://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 o https://mail.google.com.