Pattern di corrispondenza

Un pattern di corrispondenza è un URL con la seguente struttura, utilizzato per specificare un gruppo di URL:

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

scheme: deve essere uno dei seguenti, separato dal resto del pattern utilizzando i due punti seguiti da una doppia barra (://):

  • http
  • https
  • Un carattere jolly *, che corrisponde solo a http o https
  • file

Per informazioni sull'inserimento di script di contenuti in schemi non supportati, come about: e data:, consulta Inserimento nei frame correlati.

host: un nome host (www.example.com). Un * prima del nome host per trovare la corrispondenza con i sottodomini (*.example.com) o semplicemente un carattere jolly *. - Se utilizzi un carattere jolly nel pattern host, deve essere il primo o l'unico carattere e deve essere seguito da un punto (.) o da una barra (/).

port (facoltativo): porta da corrispondere. Per impostazione predefinita, questo valore viene trattato come carattere jolly con lo stesso comportamento di :*.

path: un percorso dell'URL (/example). Per le autorizzazioni host, il percorso è obbligatorio, ma viene ignorato. Il carattere jolly (/*) deve essere utilizzato per convenzione.

Le estensioni utilizzano pattern di corrispondenza in una serie di casi d'uso, tra cui:

Casi speciali

"<all_urls>"
Corrisponde a qualsiasi URL che inizia con uno schema consentito, incluso qualsiasi pattern elencato in pattern validi. Poiché influisce su tutti gli host, le recensioni del Chrome Web Store per le estensioni che lo utilizzano potrebbero richiedere più tempo.
"file:///"
Consente all'estensione di essere eseguita sui file locali. Questo pattern richiede all'utente di concedere manualmente l'accesso. Tieni presente che in questo caso sono necessarie tre barre, non due.
URL e indirizzi IP localhost
Utilizza http://localhost/* o http://127.0.0.1/* (per trovare una corrispondenza con un indirizzo IP). I pattern di corrispondenza corrispondono a tutte le porte, a meno che non ne venga specificata una esplicita.
Pattern di corrispondenza del dominio di primo livello
Chrome non supporta i pattern di corrispondenza per i domini di primo livello (TLD). Specifica i pattern di corrispondenza all'interno dei singoli TLD, come in http://google.es/* e http://google.fr/*.

Pattern di esempio

https://*/* o https://*/
Corrisponde a qualsiasi URL che utilizza lo schema https.
https://*/foo*
Corrisponde a qualsiasi URL che utilizza lo schema https, su qualsiasi host, con un percorso che inizia con foo. Alcuni esempi di corrispondenze sono https://example.com/foo/bar.html e https://www.google.com/foo.
https://*.google.com/foo*bar
Corrisponde a qualsiasi URL che utilizza lo schema https, su un host google.com, con un percorso che inizia con foo e termina con bar. Alcuni esempi di corrispondenze sono https://www.google.com/foo/baz/bar e https://docs.google.com/foobar.
file:///foo*
Corrisponde a qualsiasi file locale il cui percorso inizia con foo. Alcuni esempi di corrispondenze sono file:///foo/bar.html e file:///foo.
http://127.0.0.1/* o http://127.0.0.1/
Corrisponde a qualsiasi URL che utilizza lo schema http e si trova sull'host 127.0.0.1. Alcuni esempi di corrispondenze sono http://127.0.0.1/ e http://127.0.0.1/foo/bar.html.
http://localhost/*
Corrisponde a qualsiasi porta localhost.
*://mail.google.com/ o *://mail.google.com/*
Corrisponde a qualsiasi URL che inizia con http://mail.google.com o https://mail.google.com.