Een overeenkomstpatroon is een URL met de volgende structuur, die wordt gebruikt om een groep URL's te specificeren:
<scheme>://<host>/<path>
schema : Moet een van de volgende zijn, gescheiden van de rest van het patroon met een dubbele punt gevolgd door een dubbele schuine streep ( ://
):
-
http
-
https
- Een jokerteken
*
, dat alleen overeenkomt methttp
ofhttps
-
file
Zie Invoegen in gerelateerde frames voor informatie over het injecteren van inhoudsscripts in niet-ondersteunde schema's, zoals about:
en data:
host : een hostnaam ( www.example.com
). Een *
vóór de hostnaam om overeen te komen met subdomeinen ( *.example.com
), of gewoon een jokerteken *
. - Als u een jokerteken in het hostpatroon gebruikt, moet dit het eerste of enige teken zijn en moet het worden gevolgd door een punt ( .
) of een schuine streep ( /
).
pad : een URL-pad ( /example
). Voor hostmachtigingen is het pad vereist, maar genegeerd. Het jokerteken ( /*
) moet volgens afspraak worden gebruikt.
Extensies gebruiken matchpatronen in verschillende gebruiksscenario's, waaronder de volgende:
- Inhoudsscript injecteren.
- Het declareren van hostrechten die voor sommige Chrome API's nodig zijn naast hun eigen rechten.
- Toegang verlenen tot webtoegankelijke bronnen .
- Het verzenden en ontvangen van berichten toestaan met de manifestsleutel "externally_connectable.matches" .
Speciale gevallen
-
"<all_urls>"
- Komt overeen met elke URL die begint met een toegestaan schema, inclusief elk patroon dat wordt vermeld onder geldige patronen . Omdat het van invloed is op alle hosts, kunnen beoordelingen in de Chrome-webwinkel voor extensies die er gebruik van maken langer duren .
-
"file:///"
- Hiermee kan uw extensie op lokale bestanden worden uitgevoerd. Dit patroon vereist dat de gebruiker handmatig toegang verleent . Merk op dat in dit geval drie schuine strepen nodig zijn, niet twee.
- Localhost-URL's en IP-adressen
- Om tijdens de ontwikkeling met elke localhost-poort overeen te komen, gebruikt u
http://localhost/*
. Voor IP-adressen specificeert u het adres plus een jokerteken in het pad, zoals inhttp://127.0.0.1/*
. U kunt ookhttp://*:*/*
gebruiken om localhost, IP-adressen en elke poort te matchen. - Matchpatronen op het hoogste niveaudomein
- Chrome ondersteunt geen overeenkomstpatronen voor topniveaudomeinen (TLD's) . Geef uw overeenkomstpatronen op binnen individuele TLD's, zoals in
http://google.es/*
enhttp://google.fr/*
.
Voorbeeldpatronen
-
https://*/*
https://*/
- Komt overeen met elke URL die het
https
schema gebruikt. -
https://*/foo*
- Matcht elke URL die het
https
schema gebruikt, op elke host, met een pad dat begint metfoo
. Voorbeelden van overeenkomsten zijnhttps://example.com/foo/bar.html
enhttps://www.google.com/foo
. -
https://*.google.com/foo*bar
- Matcht elke URL die het
https
schema gebruikt, op een google.com-host, met een pad dat begint metfoo
en eindigt metbar
. Voorbeelden van overeenkomsten zijnhttps://www.google.com/foo/baz/bar
enhttps://docs.google.com/foobar
. -
file:///foo*
- Komt overeen met elk lokaal bestand waarvan het pad begint met
foo
. Voorbeelden van overeenkomsten zijnfile:///foo/bar.html
enfile:///foo
. -
http://127.0.0.1/*
http://127.0.0.1/
- Komt overeen met elke URL die het
http
schema gebruikt en zich op host 127.0.0.1 bevindt. Voorbeelden van overeenkomsten zijnhttp://127.0.0.1/
enhttp://127.0.0.1/foo/bar.html
. -
http://localhost/*
- Komt overeen met elke localhost-poort.
-
*://mail.google.com/
of*://mail.google.com/*
- Komt overeen met elke URL die begint met
http://mail.google.com
ofhttps://mail.google.com
.