דפוסי התאמה

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

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

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

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

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

מארח: שם מארח (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.