الگوی تطبیق یک 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
شروع می شود مطابقت دارد.