דפוסי התאמה

תבנית התאמה היא כתובת URL עם המבנה הבא, שמשמשת לציון קבוצה של כתובות URL:

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

סכימה: צריך להשתמש באחת מהאפשרויות הבאות, ולהפריד אותה משאר התבנית באמצעות נקודתיים ואחריהן שני לוכסנים (://):

  • http
  • https
  • תו כללי לחיפוש *, שתואם רק ל-http או ל-https
  • file

מידע על הוספת סקריפטים של תוכן לתוכניות שלא נתמכות, כמו about: ו-data:, זמין במאמר בנושא הוספה למסגרות קשורות.

‫host: שם מארח (www.example.com). אפשר להוסיף * לפני שם המארח כדי להתאים לתת-דומיינים (*.example.com), או להשתמש רק בתו כללי לחיפוש *. – אם משתמשים בתו כללי בדפוס המארח, הוא חייב להיות התו הראשון או התו היחיד, וחייבת להיות אחריו נקודה (.) או לוכסן (/).

יציאה (אופציונלי): יציאה להתאמה. כברירת מחדל, המערכת מתייחסת לתו הזה כאל תו כללי לחיפוש, כמו :*.

‫path: נתיב כתובת ה-URL ‏ (/example). כשמדובר בהרשאות מארח, נתיב כתובת ה-URL נדרש אבל המערכת מתעלמת ממנו. מומלץ להשתמש בתו הכללי לחיפוש (/*).

תוספים משתמשים בדפוסי התאמה במגוון תרחישי שימוש, כולל:

מקרים מיוחדים

"<all_urls>"
תואם לכל כתובת URL שמתחילה בסכימה מותרת, כולל כל תבנית שמפורטת בקטע תבניות תקינות. מכיוון שהיא משפיעה על כל המארחים, יכול להיות שייקח יותר זמן לבדוק ביקורות בחנות האינטרנט של Chrome על תוספים שמשתמשים בה.
"file:///"
ההרשאה מאפשרת להריץ את התוסף על קבצים מקומיים. בדפוס הזה, המשתמש צריך להעניק גישה באופן ידני. שימו לב שבמקרה הזה נדרשים שלושה לוכסנים, ולא שניים.
כתובות IP וכתובות URL של localhost
משתמשים ב-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
‫
Matches any URL using the https scheme, on a google.com host, with a path that starts with foo and ends with 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.