รูปแบบการจับคู่คือ URL ที่มีโครงสร้างต่อไปนี้ ซึ่งใช้เพื่อระบุกลุ่ม URL
<scheme>://<host>/<path>
scheme: ต้องเป็นหนึ่งในรูปแบบต่อไปนี้ โดยคั่นจากรูปแบบที่เหลือด้วยโคลอนตามด้วยเครื่องหมายทับคู่ (://)
httphttps- ไวลด์การ์ด
*ซึ่งจะจับคู่กับhttpหรือhttpsเท่านั้น file
ดูข้อมูลเกี่ยวกับการแทรกสคริปต์เนื้อหาลงในรูปแบบที่ไม่รองรับ เช่น about: และ data: ได้ที่การแทรกในเฟรมที่เกี่ยวข้อง
host: ชื่อโฮสต์ (www.example.com) * ก่อนชื่อโฮสต์เพื่อจับคู่โดเมนย่อย (*.example.com) หรือไวลด์การ์ด * เพียงอย่างเดียว
- หากคุณใช้ไวลด์การ์ดในรูปแบบโฮสต์ ไวลด์การ์ดต้องเป็นอักขระแรกหรืออักขระเดียว และตามด้วยจุด (.) หรือเครื่องหมายทับ (/)
path: เส้นทาง URL (/example) สำหรับสิทธิ์ของโฮสต์ จะต้องมีเส้นทาง แต่ระบบจะไม่สนใจ ควรใช้ไวลด์การ์ด (/*) ตามแบบแผน
ชิ้นงานใช้รูปแบบการทำงานของคีย์เวิร์ดใน Use Case ที่หลากหลาย ซึ่งรวมถึงกรณีต่อไปนี้
- การแทรกสคริปต์เนื้อหา
- การประกาศสิทธิ์การใช้โฮสต์ที่ Chrome API บางรายการกำหนดให้ใช้เพิ่มเติมจากสิทธิ์ของตนเอง
- การให้สิทธิ์เข้าถึงทรัพยากรที่เข้าถึงได้ทางเว็บ
- อนุญาตให้ส่งและรับข้อความโดยใช้คีย์ไฟล์ Manifest "externally_connectable.matches"
กรณีพิเศษ
"<all_urls>"- จับคู่กับ URL ใดก็ตามที่ขึ้นต้นด้วยรูปแบบที่อนุญาต รวมถึงรูปแบบที่แสดงอยู่ในรูปแบบที่ถูกต้อง เนื่องจากการเปลี่ยนแปลงนี้ส่งผลต่อโฮสต์ทั้งหมด การตรวจสอบส่วนขยายที่ใช้การเปลี่ยนแปลงนี้ใน Chrome เว็บสโตร์จึงอาจใช้เวลานานขึ้น
"file:///"- อนุญาตให้ส่วนขยายทํางานในไฟล์ในเครื่อง รูปแบบนี้กำหนดให้ผู้ใช้ให้สิทธิ์เข้าถึงด้วยตนเอง โปรดทราบว่าในกรณีนี้ต้องใช้เครื่องหมายทับ 3 ตัว ไม่ใช่ 2 ตัว
- URL และที่อยู่ IP ของโฮสต์ภายใน
- หากต้องการจับคู่พอร์ต localhost ในระหว่างการพัฒนา ให้ใช้
http://localhost/*สำหรับที่อยู่ IP ให้ระบุที่อยู่พร้อมกับไวลด์การ์ดในเส้นทาง เช่นhttp://127.0.0.1/*นอกจากนี้ คุณยังใช้http://*:*/*เพื่อจับคู่กับ localhost, ที่อยู่ IP และพอร์ตใดก็ได้ - รูปแบบการจับคู่โดเมนระดับบนสุด
- Chrome ไม่รองรับรูปแบบการทำงานของคีย์เวิร์ดสำหรับโดเมนระดับบนสุด (TLD) ระบุรูปแบบการทำงานของคีย์เวิร์ดภายใน TLD แต่ละรายการ เช่น
http://google.es/*และhttp://google.fr/*
ตัวอย่างรูปแบบ
https://*/*หรือhttps://*/- จับคู่กับ URL ที่ใช้รูปแบบ
https https://*/foo*- จับคู่ URL ใดก็ตามที่ใช้รูปแบบ
httpsในโฮสต์ใดก็ได้ โดยมีเส้นทางที่ขึ้นต้นด้วยfooตัวอย่างรายการที่ตรงกัน ได้แก่https://example.com/foo/bar.htmlและhttps://www.google.com/foo https://*.google.com/foo*bar- จับคู่ URL ที่ใช้รูปแบบ
httpsในโฮสต์ google.com ที่มีเส้นทางขึ้นต้นด้วยfooและลงท้ายด้วยbarตัวอย่างรายการที่ตรงกัน ได้แก่https://www.google.com/foo/baz/barและhttps://docs.google.com/foobar file:///foo*- จับคู่ไฟล์ในเครื่องที่มีเส้นทางขึ้นต้นด้วย
fooตัวอย่างรายการที่ตรงกัน ได้แก่file:///foo/bar.htmlและfile:///foo http://127.0.0.1/*หรือhttp://127.0.0.1/- จับคู่กับ URL ที่ใช้รูปแบบ
httpและอยู่ในโฮสต์ 127.0.0.1 ตัวอย่างรายการที่ตรงกัน ได้แก่http://127.0.0.1/และhttp://127.0.0.1/foo/bar.html http://localhost/*- ตรงกับพอร์ต localhost ใดก็ได้
*://mail.google.com/หรือ*://mail.google.com/*- จับคู่ URL ใดก็ตามที่ขึ้นต้นด้วย
http://mail.google.comหรือhttps://mail.google.com