Pattern di corrispondenza

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

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

schema: deve essere uno dei seguenti, separato dal resto del pattern 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 di frame correlati.

host: un nome host (www.example.com). Un * prima del nome host per trovare corrispondenze con i sottodomini (*.example.com) o solo 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 dell'host, il percorso è obbligatorio, ma viene ignorato. Il carattere jolly (/*) deve essere utilizzato per convenzione.

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

Casi particolari

"<all_urls>"
Corrisponde a qualsiasi URL che inizia con uno schema consentito, inclusi i pattern elencati in pattern validi. Dal momento che interessa tutti gli host, il Chrome Web Store esamina le estensioni che lo utilizzano potrebbe richiedere più tempo.
"file:///"
Consente l'esecuzione della tua estensione su file locali. Questo pattern richiede che l'utente conceda l'accesso manualmente. Tieni presente che questo caso richiede tre barre, non due.
URL e indirizzi IP Localhost
Per trovare la 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 indicato in http://127.0.0.1/*. Puoi anche utilizzare http://*:*/* per associare localhost, indirizzi IP e qualsiasi porta.
Pattern di corrispondenza del dominio di primo livello
Chrome non supporta i pattern di corrispondenza per i domini di primo livello (TLD). Specifica i tuoi pattern di corrispondenza all'interno di singoli domini di primo livello, ad esempio http://google.es/* e http://google.fr/*.

Pattern di esempio

https://*/* o https://*/
Corrisponde a qualsiasi URL utilizzando lo schema https.
https://*/foo*
Corrisponde a qualsiasi URL che utilizza lo schema https, su qualsiasi host, con un percorso che inizia con foo. Esempi di corrispondenze includono 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. Esempi di corrispondenze includono 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. Esempi di corrispondenze includono 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. Esempi di corrispondenze includono 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.