דפוסי התאמה

ההתאמה של הרשאות מארח וסקריפט תוכן מבוססת על קבוצה של כתובות URL שמוגדרות על ידי תבניות התאמה. תבנית התאמה היא בעצם כתובת URL שמתחילה בסכימה מותרת (http,‏ https,‏ file או ftp) ויכולה להכיל תווים של *. התבנית המיוחדת <all_urls> תואמת לכל כתובת URL שמתחילה בסכימה מותרת. כל תבנית התאמה מורכבת מ-3 חלקים:

  • סכימה – לדוגמה, http או file או *

    הערה: הגישה לכתובות URL של file לא אוטומטית. המשתמש צריך להיכנס לדף ניהול התוספים ולהסכים לגישה ל-file עבור כל תוסף שמבקש גישה.

  • ‫host – לדוגמה, www.google.com או *.google.com או *. אם הסכמה היא file, אין חלק של host

  • ‫path – לדוגמה, /*,‏ /foo* או /foo/bar. הנתיב חייב להיות בהרשאת מארח, אבל תמיד מתייחסים אליו כאל /*.

כללי התחביר הבסיסיים:

&lt;url-pattern&gt; := &lt;scheme&gt;://&lt;host&gt;&lt;path&gt;
&lt;scheme&gt; := '*' | 'http' | 'https' | 'file' | 'ftp' | 'urn'
&lt;host&gt; := '*' | '*.' &lt;any char except '/' and '*'&gt;+
&lt;path&gt; := '/' &lt;any chars&gt;

המשמעות של '*' תלויה במיקום שלה: סכימה, מארח או נתיב. אם הסכימה היא *, היא תתאים ל-http או ל-https, אבל לא ל-file, ל-ftp או ל-urn. אם המארח הוא רק *, הוא תואם לכל מארח. אם המארח הוא *._hostname_, הוא תואם למארח שצוין או לכל אחד מתתי-הדומיינים שלו. בקטע path, כל '*' תואם ל-0 או יותר תווים. בטבלה הבאה מוצגות כמה תבניות תקינות.

דוגמת קודתיאורדוגמאות לכתובות URL תואמות
http://*/*התאמה לכל כתובת URL שמשתמשת בסכימה httphttp://www.google.com/
http://example.org/foo/bar.html
http://*/foo*תואם לכל כתובת URL שמשתמשת בסכימה http, בכל מארח, כל עוד הנתיב מתחיל ב-/foohttp://example.com/foo/bar.html
http://www.google.com/foo
https://*.google.com/foo*barתואם לכל כתובת URL שמשתמשת בסכימה https, נמצאת במארח google.com (כמו www.google.com,‏ docs.google.com או google.com), כל עוד הנתיב מתחיל ב-/foo ומסתיים ב-barhttps://www.google.com/foo/baz/bar
https://docs.google.com/foobar
http://example.org/foo/bar.htmlהתאמה לכתובת ה-URL שצוינהhttp://example.org/foo/bar.html
file:///foo*תואם לכל קובץ מקומי שהנתיב שלו מתחיל ב-/foofile:///foo/bar.html
file:///foo
http://127.0.0.1/*תואם לכל כתובת URL שמשתמשת בסכימה http ונמצאת במארח 127.0.0.1http://127.0.0.1/
http://127.0.0.1/foo/bar.html
*://mail.google.com/*תואם לכל כתובת URL שמתחילה ב-http://mail.google.com או ב-https://mail.google.com.http://mail.google.com/foo/baz/bar
https://mail.google.com/foobar
urn:*תואם לכל כתובת URL שמתחילה ב-urn:.urn:uuid:54723bea-c94e-480e-80c8-a69846c3f582
urn:uuid:cfa40aff-07df-45b2-9f95-e023bcf4a6da
<all_urls>התאמה לכל כתובת URL שמשתמשת בסכמה מותרת. (רשימת הסכימות המותרות מופיעה בתחילת הקטע הזה).http://example.org/foo/bar.html
file:///bar/baz.html

הנה כמה דוגמאות להתאמות של תבניות שהן לא חוקיות:

דוגמת עיצוב שגויהלמה זה רע
http://www.google.comאין נתיב
http://*foo/barאחרי '*' במארח יכולים להופיע רק '.' או '/'
http://foo.*.bar/baz אם התו '*' מופיע במארח, הוא חייב להיות התו הראשון
http:/barחסר מפריד סכימה (צריך להיות '//' במקום '/')
foo://*סכמה לא תקינה

חלק מהסכמות לא נתמכות בכל ההקשרים.