Overeenkomen met patronen

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 schuine streep ( // ):

  • http
  • https
  • Een jokerteken * , dat alleen overeenkomt met http of https
  • 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:

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 in http://127.0.0.1/* . U kunt ook http://*:*/* gebruiken om localhost, IP-adressen en elke poort te matchen.
Matchpatronen op het hoogste niveaudomein
Chrome ondersteunt geen overeenkomstpatronen voor topniveaudomeinen (TLD) . Geef uw overeenkomstpatronen op binnen individuele TLD's, zoals in http://google.es/* en http://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 met foo . Voorbeelden van overeenkomsten zijn https://example.com/foo/bar.html en https://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 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/* 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 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 .