مطابقة الأنماط

نمط المطابقة هو عنوان URL يتضمّن البنية التالية، ويتم استخدامه لتحديد مجموعة من عناوين URL:

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

مخطّط: يجب أن يكون أحد الخيارات التالية، مع فصله عن بقية النمط باستخدام شرطة مائلة مزدوجة (//):

  • http
  • https
  • حرف البدل * الذي يتطابق مع http أو https فقط
  • file

للحصول على معلومات عن إدراج نصوص برمجية للمحتوى في المخططات غير المتوافقة، مثل about: وdata:، يُرجى الاطّلاع على الإدراج في الإطارات ذات الصلة.

‫host: اسم مضيف (www.example.com). * قبل اسم المضيف لمطابقة النطاقات الفرعية (*.example.com)، أو حرف بدل * فقط. - في حال استخدام حرف بدل في نمط المضيف، يجب أن يكون الحرف الأول أو الوحيد، ويجب أن يتبعه نقطة (.) أو الشرطة المائلة للأمام (/).

path: مسار عنوان URL (/example). بالنسبة إلى أذونات المضيف، يكون المسار مطلوبًا ولكن يتم تجاهله. يجب استخدام حرف البدل (/*) وفقًا للعرف.

تستخدِم الإضافات أنماط المطابقة في مجموعة متنوّعة من حالات الاستخدام، بما في ذلك ما يلي:

الحالات الخاصة

"<all_urls>"
يطابق أي عنوان URL يبدأ بنظام مسموح به، بما في ذلك أي نمط مُدرَج ضمن الأنماط الصالحة. ولأنّ هذا الإجراء يؤثر في جميع المضيفين، قد تستغرق مراجعات "سوق Chrome الإلكتروني" للإضافات التي تستخدمه وقتًا أطول.
"file:///"
يسمح هذا الإذن لإضافة Chrome بتشغيل الملفات على الجهاز. يتطلب هذا النمط من المستخدم منح إمكانية الوصول يدويًا. يُرجى العِلم أنّ هذه الحالة تتطلّب استخدام ثلاثة شرطات وليس شرطتَين.
عناوين 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/*
تطابق أي منفذ localhost.
*://mail.google.com/ أو *://mail.google.com/*
يطابق أي عنوان URL يبدأ بـ http://mail.google.com أو https://mail.google.com.