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 ahttp
ohttps
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:
- Inserimento di uno script di contenuti.
- Dichiarazione delle autorizzazioni host richieste da alcune API di Chrome in aggiunta alle proprie autorizzazioni.
- Concedere l'accesso a risorse accessibili dal web.
- Consentire l'invio e la ricezione di messaggi tramite la chiave manifest "externally_connectable.matches".
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 inhttp://127.0.0.1/*
. Puoi anche utilizzarehttp://*:*/*
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/*
ehttp://google.fr/*
.
Pattern di esempio
https://*/*
ohttps://*/
- 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 confoo
. Esempi di corrispondenze includonohttps://example.com/foo/bar.html
ehttps://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 confoo
e termina conbar
. Esempi di corrispondenze includonohttps://www.google.com/foo/baz/bar
ehttps://docs.google.com/foobar
. file:///foo*
- Corrisponde a qualsiasi file locale il cui percorso inizia con
foo
. Esempi di corrispondenze includonofile:///foo/bar.html
efile:///foo
. http://127.0.0.1/*
ohttp://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 includonohttp://127.0.0.1/
ehttp://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
ohttps://mail.google.com
.