דפוסי התאמה

דפוס התאמה הוא כתובת 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). יש לציין את דפוסי ההתאמה בדומיינים ספציפיים ברמה העליונה, כמו http://google.es/* ו-http://google.fr/*.

תבניות לדוגמה

https://*/* או https://*/
תואם לכל כתובת אתר באמצעות הסכמה https.
https://*/foo*
התאמה לכל כתובת URL באמצעות הסכמה https, בכל מארח, עם נתיב שמתחיל ב-foo. דוגמאות להתאמות: https://example.com/foo/bar.html ו-https://www.google.com/foo.
https://*.google.com/foo*bar
תואם לכל כתובת אתר באמצעות הסכמה 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/
תואם לכל כתובת אתר שמשתמשת בסכימה 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/*
התאמה לכל כתובת אתר שמתחילה ב-http://mail.google.com או ב-https://mail.google.com.