รูปแบบการจับคู่

รูปแบบการจับคู่คือ URL ที่มีโครงสร้างต่อไปนี้ ซึ่งใช้เพื่อระบุกลุ่ม URL

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

รูปแบบ: ต้องเป็นรูปแบบใดรูปแบบหนึ่งต่อไปนี้ โดยคั่นจากส่วนที่เหลือของรูปแบบด้วยโคลอนตามด้วยดับเบิลสแลช (://)

  • http
  • https
  • ไวลด์การ์ด * ซึ่งตรงกับ http หรือ https เท่านั้น
  • file

ดูข้อมูลเกี่ยวกับการแทรก Content Script ลงในสคีมที่ไม่รองรับ เช่น about: และ data: ได้ที่การแทรกในเฟรมที่เกี่ยวข้อง

โฮสต์: ชื่อโฮสต์ (www.example.com) * ก่อนชื่อโฮสต์เพื่อจับคู่โดเมนย่อย (*.example.com) หรือเพียงแค่ไวลด์การ์ด * - หากใช้ไวลด์การ์ดในรูปแบบโฮสต์ ไวลด์การ์ดต้องเป็นอักขระแรกหรืออักขระเดียว และต้องตามด้วยจุด (.) หรือเครื่องหมายทับ (/)

พอร์ต (ไม่บังคับ): พอร์ตที่จะจับคู่ โดยค่าเริ่มต้น ระบบจะถือว่านี่เป็นไวลด์การ์ดที่มีลักษณะการทำงานเหมือนกับ :*

path: เส้นทาง URL (/example) สำหรับสิทธิ์การใช้โฮสต์ ระบบจะกำหนดให้ระบุเส้นทางแต่จะไม่สนใจเส้นทางดังกล่าว ควรใช้ไวลด์การ์ด (/*) ตามธรรมเนียม

ส่วนขยายใช้รูปแบบการจับคู่ในกรณีการใช้งานที่หลากหลาย ซึ่งรวมถึงกรณีต่อไปนี้

กรณีพิเศษ

"<all_urls>"
จับคู่ URL ใดก็ตามที่ขึ้นต้นด้วยรูปแบบที่อนุญาต รวมถึงรูปแบบใดก็ตามที่แสดงในส่วนรูปแบบที่ถูกต้อง เนื่องจากส่งผลต่อโฮสต์ทั้งหมด รีวิวใน Chrome เว็บสโตร์สำหรับส่วนขยายที่ใช้ฟีเจอร์นี้อาจใช้เวลานานขึ้น
"file:///"
อนุญาตให้ส่วนขยายทำงานกับไฟล์ในเครื่อง รูปแบบนี้กำหนดให้ผู้ใช้ต้องให้สิทธิ์เข้าถึงด้วยตนเอง โปรดทราบว่าในกรณีนี้ต้องใช้เครื่องหมายทับ 3 อัน ไม่ใช่ 2 อัน
URL และที่อยู่ IP ของ localhost
ใช้ http://localhost/* หรือ http://127.0.0.1/* (เพื่อจับคู่ที่อยู่ 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