דפוס התאמה הוא כתובת URL עם המבנה הבא, שמשמשת לציון קבוצה של כתובות URL:
<scheme>://<host>/<path>
scheme: חייב להיות אחד מהבאים, ולהפריד משאר התבנית באמצעות קו נטוי כפול (//
):
http
https
- תו כללי לחיפוש
*
, שתואם רק ל-http
או ל-https
file
מידע על הזרקת סקריפטים של תוכן לסכמות שלא נתמכות, כמו about:
ו-data:
, זמין במאמר הזרקה בפריימים קשורים.
מארח: שם מארח (www.example.com
), *
לפני שם המארח כדי להתאים לתת-דומיינים (*.example.com
), או רק תו כללי *
.
- אם משתמשים בתו כללי לחיפוש בדפוס המארח, הוא חייב להיות התו הראשון או התו היחיד, ואחריו חייב להופיע נקודה (.
) או קו נטוי קדימה (/
).
path: נתיב כתובת ה-URL (/example
). בשביל הרשאות מארח, הנתיב נדרש אבל המערכת מתעלמת ממנו. מומלץ להשתמש בתווים הכלליים לחיפוש (/*
) לפי הסכמה.
התוספים משתמשים בדפוסי התאמה במגוון תרחישים לדוגמה, כולל:
- החדרת סקריפט תוכן.
- הצהרה על הרשאות המארח שנדרשות לחלק מממשקי ה-API של Chrome בנוסף להרשאות שלהם.
- הענקת גישה למשאבים שגלויים באינטרנט.
- שליחה וקבלה של הודעות באמצעות מפתח המניפסט "externally_connectable.matches".
מקרים מיוחדים
"<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
.