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

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

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

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

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

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

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

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

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

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

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