Mẫu so khớp

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

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

lược đồ: 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, theo sau là dấu gạch chéo đôi (://):

  • 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 giao thứ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.

máy chủ lưu trữ: Tên máy chủ (www.example.com). * trước tên máy chủ để so khớp 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ì đó phải là ký tự đầu tiên hoặc duy nhất và phải theo sau là dấu chấm (.) hoặc dấu gạch chéo lên (/).

path: Đường dẫn URL (/example). Đối với quyền của 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 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 giao thứ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ả máy chủ lưu trữ, nên quy trình xem xét của Cửa hàng Chrome trực tuyến đối với các 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 ba dấu gạch chéo, chứ không phải hai.
URL và địa chỉ IP của máy chủ lưu trữ cục bộ
Để so khớp bất kỳ cổng localhost nào trong quá trình phát triển, hãy sử dụng http://localhost/*. Đối với địa chỉ IP, hãy chỉ định địa chỉ cùng với ký tự đại diện trong đường dẫn, như trong http://127.0.0.1/*. Bạn cũng có thể sử dụng http://*:*/* để so khớp máy chủ cục bộ, địa chỉ IP và bất kỳ cổng nào.
Mẫu so khớp miền cấp cao nhất
Chrome không hỗ trợ mẫu khớp cho miền cấp cao nhất (TLD). Chỉ định mẫu khớp trong từng TLD, như trong http://google.es/* và http://google.fr/*.

Mẫu ví dụ

https://*/* hoặc https://*/
Khớp với mọi URL sử dụng giao thức https.
https://*/foo*
Khớp với mọi URL sử dụng lược đồ https, trên bất kỳ máy chủ lưu trữ nào, với đường dẫn bắt đầu bằng foo. Ví dụ về các kết quả trùng 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 giao thức https, trên máy chủ google.com, với đường dẫn bắt đầu bằng foo và kết thúc bằng bar. Ví dụ về các kết quả trùng 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 kết quả trùng 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 kết quả trùng 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.