Patrones de coincidencia

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

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 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://*/
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 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 utilice 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.