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

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

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

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

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

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

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

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

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

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

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