Overeenkomen met patronen

Een matchpatroon is een URL met de volgende structuur, die wordt gebruikt om een ​​groep URL's te specificeren:

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

Schema : Moet een van de volgende zijn, gescheiden van de rest van het patroon door een dubbele punt gevolgd door een dubbele schuine streep ( :// ):

  • http
  • https
  • Een jokerteken * , dat alleen overeenkomt met http of https
  • file

Voor informatie over het injecteren van inhoudsscripts in niet-ondersteunde schema's, zoals about: en data: :, zie Injecteren in gerelateerde frames .

host : Een hostnaam ( www.example.com ). Een * vóór de hostnaam om subdomeinen te matchen ( *.example.com ), of gewoon een wildcard * . - Als u een wildcard in het hostpatroon gebruikt, moet dit het eerste of enige teken zijn en moet het gevolgd worden door een punt ( . ) of een schuine streep ( / ).

poort (optioneel) : Poort om te matchen. Standaard wordt dit behandeld als een wildcard met hetzelfde gedrag als :* .

pad : Een URL-pad ( /example ). Voor hostrechten is het pad vereist, maar wordt genegeerd. Het wildcard-teken ( /* ) moet volgens de conventie worden gebruikt.

Extensies gebruiken overeenkomstpatronen in diverse toepassingen, waaronder de volgende:

Bijzondere 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 alle hosts beïnvloedt, kan het langer duren voordat Chrome Web Store-beoordelingen voor extensies die dit gebruiken, worden verwerkt.
"file:///"
Hiermee kan uw extensie op lokale bestanden worden uitgevoerd. Dit patroon vereist dat de gebruiker handmatig toegang verleent . Let op: in dit geval zijn drie schuine strepen nodig, niet twee.
Localhost-URL's en IP-adressen
Gebruik http://localhost/* of http://127.0.0.1/* (om een ​​IP-adres te matchen). Matchpatronen matchen alle poorten, tenzij een expliciete poort is opgegeven.
Overeenkomstpatronen voor topniveaudomeinen
Chrome ondersteunt geen zoekpatronen voor topdomeinen (TLD's) . Specificeer uw zoekpatronen binnen individuele TLD's, zoals in http://google.es/* en http://google.fr/* .

Voorbeeldpatronen

https://*/* of https://*/
Komt overeen met elke URL die gebruikmaakt van het https schema.
https://*/foo*
Komt overeen met elke URL die het https schema gebruikt, op elke host, met een pad dat begint met foo . Voorbeelden van overeenkomsten zijn https://example.com/foo/bar.html en https://www.google.com/foo .
https://*.google.com/foo*bar
Komt overeen met elke URL die gebruikmaakt van het https schema, op een google.com-host, met een pad dat begint met foo en eindigt met bar . Voorbeelden van overeenkomsten zijn https://www.google.com/foo/baz/bar en https://docs.google.com/foobar .
file:///foo*
Komt overeen met elk lokaal bestand waarvan het pad begint met foo . Voorbeelden van overeenkomsten zijn file:///foo/bar.html en file:///foo .
http://127.0.0.1/* of http://127.0.0.1/
Komt overeen met elke URL die het http schema gebruikt en zich op de host 127.0.0.1 bevindt. Voorbeelden van overeenkomsten zijn http://127.0.0.1/ en http://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 of https://mail.google.com .