Pattern di corrispondenza

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

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

scheme: deve essere uno dei seguenti, separato dal resto del pattern mediante 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 Inserzione in frame correlati.

host: un nome host (www.example.com). Un * prima del nome host per trovare corrispondenze 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 (/).

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 i pattern di corrispondenza in una serie di casi d'uso, tra cui:

Casi particolari

"<all_urls>"
Corrisponde a qualsiasi URL che inizia con uno schema consentito, inclusi tutti i pattern elencati nella sezione Pattern validi. Poiché interessa tutti gli host, le revisioni 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 l'accesso manualmente. Tieni presente che in questo caso sono necessarie tre barre, non due.
URL e indirizzi IP di localhost
Per trovare una corrispondenza con qualsiasi porta localhost durante lo sviluppo, utilizza http://localhost/*. Per gli indirizzi IP, specifica l'indirizzo più un carattere jolly nel percorso, come in http://127.0.0.1/*. Puoi anche utilizzare http://*:*/* per trovare corrispondenze per localhost, indirizzi IP e qualsiasi porta.
Pattern di corrispondenza dei domini 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.