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>:<port>/<path>

esquema: Debe ser uno de los siguientes, separado del resto del patrón con dos puntos seguidos de una doble barra (://):

  • 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 admitidos, como about: y data:, consulta Cómo insertar en marcos relacionados.

host: Es un nombre de host (www.example.com), 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 único carácter, y debe ir seguido de un punto (.) o una barra diagonal (/).

port (opcional): Es el puerto que se debe coincidir. De forma predeterminada, se trata como un comodín con el mismo comportamiento que :*.

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 por 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 encuentre en patrones válidos. Debido a que afecta a todos los hosts, las revisiones de Chrome Web Store para las extensiones que lo 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
Usa http://localhost/* o http://127.0.0.1/* (para que coincida con una dirección IP). Los patrones de coincidencia coinciden con todos los puertos, a menos que se especifique un puerto explícito.
Patrones de coincidencia de dominios de nivel superior
Chrome no admite patrones de coincidencia para los dominios de nivel superior (TLD). Especifica tus patrones de coincidencia dentro de los TLD individuales, como en http://google.es/* y http://google.fr/*.

Patrones de ejemplo

https://*/* o https://*/
Coincide con cualquier URL que utilice 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 utilice el esquema https, en un host de google.com, con una ruta que comience con foo y termine 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.