דפוסי התאמה

תבנית התאמה היא כתובת 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 של localhost
כדי להתאים לכל יציאה של localhost במהלך הפיתוח, משתמשים ב-http://localhost/*. בכתובות IP, מציינים את הכתובת בתוספת תו כללי לחיפוש בנתיב, כמו 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.