Mẫu so khớp

Mẫu so khớp là một URL có cấu trúc sau, được dùng để chỉ định một nhóm URL:

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

scheme: Phải là một trong những giá trị sau, được phân tách với phần còn lại của mẫu bằng dấu hai chấm, sau đó là dấu gạch chéo kép (://):

  • http
  • https
  • Ký tự đại diện *, chỉ khớp với http hoặc https
  • file

Để biết thông tin về cách chèn tập lệnh nội dung vào các lược đồ không được hỗ trợ, chẳng hạn như about: và data:, hãy xem phần Chèn vào các khung liên quan.

host: Tên máy chủ (www.example.com). * trước tên máy chủ để so khớp các miền con (*.example.com) hoặc chỉ là ký tự đại diện *. – Nếu bạn sử dụng ký tự đại diện trong mẫu máy chủ lưu trữ, thì ký tự đó phải là ký tự đầu tiên hoặc duy nhất, đồng thời phải theo sau là dấu chấm (.) hoặc dấu gạch chéo (/).

port (không bắt buộc): Cổng cần so khớp. Theo mặc định, đây được coi là một ký tự đại diện có hành vi giống như :*.

path: Đường dẫn URL (/example). Đối với quyền truy cập vào máy chủ lưu trữ, đường dẫn là bắt buộc nhưng sẽ bị bỏ qua. Bạn nên sử dụng ký tự đại diện (/*) theo quy ước.

Tiện ích sử dụng mẫu so khớp trong nhiều trường hợp sử dụng, bao gồm cả những trường hợp sau:

Các trường hợp đặc biệt

"<all_urls>"
Khớp với mọi URL bắt đầu bằng một lược đồ được phép, bao gồm mọi mẫu được liệt kê trong phần mẫu hợp lệ. Vì ảnh hưởng đến tất cả các máy chủ lưu trữ, nên các bài đánh giá trên Cửa hàng Chrome trực tuyến đối với những tiện ích sử dụng API này có thể mất nhiều thời gian hơn.
"file:///"
Cho phép tiện ích của bạn chạy trên các tệp cục bộ. Mẫu này yêu cầu người dùng cấp quyền truy cập theo cách thủ công. Xin lưu ý rằng trường hợp này yêu cầu 3 dấu gạch chéo chứ không phải 2.
URL và địa chỉ IP của máy chủ lưu trữ cục bộ
Sử dụng http://localhost/* hoặc http://127.0.0.1/* (để so khớp một địa chỉ IP). Mẫu so khớp sẽ so khớp tất cả các cổng, trừ phi bạn chỉ định một cổng cụ thể.
Mẫu trùng khớp miền cấp cao nhất
Chrome không hỗ trợ mẫu so khớp cho miền cấp cao nhất (TLD). Chỉ định mẫu khớp trong từng miền cấp cao nhất, chẳng hạn như http://google.es/* và http://google.fr/*.

Mẫu ví dụ

https://*/* hoặc https://*/
Khớp với mọi URL bằng lược đồ https.
https://*/foo*
Khớp với mọi URL sử dụng lược đồ https, trên mọi máy chủ lưu trữ, có đường dẫn bắt đầu bằng foo. Ví dụ về các trường hợp khớp bao gồm https://example.com/foo/bar.html và https://www.google.com/foo.
https://*.google.com/foo*bar
Khớp với mọi URL sử dụng lược đồ https, trên một máy chủ lưu trữ google.com, có đường dẫn bắt đầu bằng foo và kết thúc bằng bar. Ví dụ về các trường hợp khớp bao gồm https://www.google.com/foo/baz/bar và https://docs.google.com/foobar.
file:///foo*
Khớp với mọi tệp cục bộ có đường dẫn bắt đầu bằng foo. Ví dụ về các trường hợp khớp bao gồm file:///foo/bar.html và file:///foo.
http://127.0.0.1/* hoặc http://127.0.0.1/
Khớp với mọi URL sử dụng lược đồ http và nằm trên máy chủ lưu trữ 127.0.0.1. Ví dụ về các trường hợp khớp bao gồm http://127.0.0.1/ và http://127.0.0.1/foo/bar.html.
http://localhost/*
Khớp với mọi cổng máy chủ cục bộ.
*://mail.google.com/ hoặc *://mail.google.com/*
Khớp với mọi URL bắt đầu bằng http://mail.google.com hoặc https://mail.google.com.