الگوها را مطابقت دهید

الگوی تطبیق یک URL با ساختار زیر است که برای تعیین گروهی از URL ها استفاده می شود:

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

طرح : باید یکی از موارد زیر باشد و با استفاده از یک اسلش دوتایی ( // ) از بقیه الگو جدا شود:

• http
• https
• یک علامت * ، که فقط با http یا https مطابقت دارد
• file

برای اطلاعات در مورد تزریق اسکریپت‌های محتوا به طرح‌های پشتیبانی‌نشده، مانند about: و data: به تزریق در فریم‌های مرتبط مراجعه کنید.

میزبان : نام میزبان ( www.example.com ). یک * قبل از نام میزبان برای مطابقت با زیر دامنه ها ( *.example.com )، یا فقط یک علامت * . - اگر از علامت عام در الگوی میزبان استفاده می کنید، باید اولین یا تنها کاراکتر باشد و باید نقطه ( . ) یا اسلش جلو ( / ) به دنبال آن باشد.

path : یک مسیر URL ( /example ). برای مجوزهای میزبان، مسیر مورد نیاز است اما نادیده گرفته می شود. علامت عام ( /* ) باید طبق قرارداد استفاده شود.

برنامه های افزودنی از الگوهای مطابقت در موارد مختلف استفاده می کنند، از جمله موارد زیر:

• اسکریپت تزریق محتوا
• اعلام مجوزهای میزبانی که برخی از APIهای Chrome علاوه بر مجوزهای خود به آن نیاز دارند.
• اعطای دسترسی به منابع قابل دسترس تحت وب .
• امکان ارسال و دریافت پیام با استفاده از کلید مانیفست "externally_connectable.matches" .

موارد خاص

"<all_urls>"

با هر نشانی اینترنتی که با یک طرح مجاز شروع می شود، از جمله هر الگوی فهرست شده در الگوهای معتبر مطابقت دارد. از آنجایی که همه میزبان‌ها را تحت تأثیر قرار می‌دهد، بررسی فروشگاه وب Chrome برای افزونه‌هایی که از آن استفاده می‌کنند ممکن است بیشتر طول بکشد .

"file:///"

به برنامه افزودنی شما اجازه می دهد تا روی فایل های محلی اجرا شود. این الگو به کاربر نیاز دارد که به صورت دستی اجازه دسترسی بدهد . توجه داشته باشید که این مورد نیاز به سه اسلش دارد نه دو.

URL ها و آدرس های IP Localhost

برای مطابقت با هر پورت لوکال هاست در طول توسعه، از http://localhost/* استفاده کنید. برای آدرس‌های IP، مانند http://127.0.0.1/* ، آدرس را به اضافه یک علامت عام در مسیر مشخص کنید. همچنین می توانید از http://*:*/* برای مطابقت با لوکال هاست، آدرس های 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/*

با هر پورت لوکال هاست مطابقت دارد.

*://mail.google.com/ یا *://mail.google.com/*

با هر URL که با http://mail.google.com یا https://mail.google.com شروع می شود مطابقت دارد.