รูปแบบการจับคู่คือ URL ที่มีโครงสร้างต่อไปนี้ ซึ่งใช้เพื่อระบุกลุ่ม URL
<scheme>://<host>/<path>
scheme: ต้องเป็นหนึ่งในรูปแบบต่อไปนี้ โดยคั่นจากรูปแบบที่เหลือด้วยโคลอนตามด้วยเครื่องหมายทับคู่ (://
)
http
https
- ไวลด์การ์ด
*
ซึ่งจะจับคู่กับ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