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

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

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

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

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

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

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

المنفذ (اختياري): المنفذ المطلوب مطابقته. يتم تلقائيًا التعامل مع هذا الحقل كحرف بدل مع السلوك نفسه الذي يتبعه :*.

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

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

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

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