chrome.extensionTypes

תיאור

ה-API chrome.extensionTypes מכיל הצהרות סוגים עבור תוספים ל-Chrome.

סוגים

CSSOrigin

Chrome 66 ומעלה

המקור של ה-CSS שהוזן.

טיפוסים בני מנייה (enum)

DeleteInjectionDetails

Chrome 87 ומעלה

פרטים על שירות ה-CSS להסרה. יש להגדיר את הקוד או את מאפיין הקובץ, אבל אי אפשר להגדיר את שניהם בו-זמנית.

תכונות

  • allFrames

    בוליאני אופציונלי

    אם ה-allFrames הוא true, סימן שצריך להסיר את ה-CSS מכל המסגרות של הדף הנוכחי. כברירת מחדל, הגודל הוא false, והוא מוסר רק מהפריים העליון. אם true ו-frameId מוגדרים, הקוד יוסר מהמסגרת שנבחרה ומכל מסגרות הצאצא שלו.

  • קוד

    מחרוזת אופציונלי

    קוד CSS להסרה.

  • cssOrigin

    CSSOrigin אופציונלי

    המקור של ה-CSS שיש להסיר. ברירת המחדל היא "author".

  • קובץ

    מחרוזת אופציונלי

    קובץ CSS להסרה.

  • frameId

    מספר אופציונלי

    ה-frame שממנו יש להסיר את ה-CSS. ברירת המחדל היא 0 (המסגרת ברמה העליונה).

  • matchAboutBlank

    בוליאני אופציונלי

    אם הערך MatchaboutEmpty הוא TRUE, הקוד יוסר גם ממסגרות about:blank ו-about:srcdoc, אם לתוסף שלך יש גישה למסמך ההורה. ברירת המחדל היא false.

DocumentLifecycle

Chrome 106 ומעלה

מחזור החיים של המסמך של המסגרת.

טיפוסים בני מנייה (enum)

ExecutionWorld

Chrome 111 ומעלה

עולם ה-JavaScript שבו סקריפט יופעל. יכול להיות עולם מבודד וייחודי לתוסף זה, העולם הראשי של ה-DOM המשותף עם ה-JavaScript של הדף, או עולם סקריפטים של משתמש שזמין רק עבור סקריפטים שנרשמו ב-User Scripts API.

טיפוסים בני מנייה (enum)

"ISOLATED"

FrameType

Chrome 106 ומעלה

סוג המסגרת.

טיפוסים בני מנייה (enum)

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDetails

פרטים על הפורמט והאיכות של תמונה.

תכונות

  • פורמט

    ImageFormat אופציונלי

    הפורמט של התמונה שמתקבלת. ברירת המחדל היא "jpeg".

  • איכות

    מספר אופציונלי

    כשהפורמט הוא "jpeg", קובע את איכות התמונה שתתקבל. בתמונות PNG המערכת מתעלמת מהערך הזה. ככל שהאיכות תיפגע, התמונה שתתקבל תכלול יותר ארטיפקטים חזותיים, ומספר הבייטים שיידרש כדי לאחסן אותה יקטן.

ImageFormat

Chrome 44 ואילך

הפורמט של תמונה.

טיפוסים בני מנייה (enum)

"jpeg"

"png"

InjectDetails

פרטים על הסקריפט או על ה-CSS שיש להחדיר. יש להגדיר את הקוד או את מאפיין הקובץ, אבל אי אפשר להגדיר את שניהם בו-זמנית.

תכונות

  • allFrames

    בוליאני אופציונלי

    אם ה-allFrames הוא true, סימן שיש להחדיר את ה-JavaScript או ה-CSS לכל המסגרות של הדף הנוכחי. כברירת מחדל, הגודל הוא false והוא מוחדר לפריים העליון בלבד. אם true ו-frameId מוגדרים, הקוד יתווסף למסגרת שנבחרה ולכל מסגרות הצאצא שלו.

  • קוד

    מחרוזת אופציונלי

    קוד JavaScript או קוד CSS שיש להחדיר.

    אזהרה: כדאי להיזהר כשמשתמשים בפרמטר code. שימוש שגוי בו עלול לחשוף את התוסף שלך למתקפות של סקריפטים חוצי אתרים

  • cssOrigin

    CSSOrigin אופציונלי

    Chrome 66 ומעלה

    המקור של ה-CSS שיש להחדיר. אפשר לציין את הערך הזה רק עבור CSS, ולא עבור JavaScript. ברירת המחדל היא "author".

  • קובץ

    מחרוזת אופציונלי

    JavaScript או קובץ CSS שיש להחדיר.

  • frameId

    מספר אופציונלי

    Chrome מגרסה 50 ואילך

    ה-frame שאליו יש להזריק את הסקריפט או ה-CSS. ברירת המחדל היא 0 (המסגרת ברמה העליונה).

  • matchAboutBlank

    בוליאני אופציונלי

    אם הערך MatchaboutEmpty הוא TRUE, הקוד גם יוחדר למסגרות about:blank ו-about:srcdoc אם לתוסף שלך יש גישה למסמך ההורה שלו. לא ניתן להוסיף את הקוד ברמה העליונה about:-frames. ברירת המחדל היא false.

  • runAt

    RunAt אופציונלי

    בהקדם האפשרי שבו ה-JavaScript או ה-CSS יוכנסו לכרטיסייה. ברירת המחדל היא "document_idle".

RunAt

Chrome 44 ואילך

בהקדם האפשרי שבו ה-JavaScript או ה-CSS יוכנסו לכרטיסייה.

טיפוסים בני מנייה (enum)

"document_start"
הסקריפט מוחדר אחרי כל קובץ מ-CSS, אבל לפני שנוצרת DOM אחר או לפני הרצה של סקריפט אחר.

"document_end"
הסקריפט מוחדר מיד אחרי שה-DOM הושלם, אבל לפני שמשאבי המשנה נטענים, כמו תמונות ומסגרות.

"document_idle"
הדפדפן בוחר זמן להחדרת הסקריפט בין "document_end" ומיד לאחר שהאירוע window.onload מופעל. רגע ההזרקה המדויק תלוי עד כמה המסמך מורכב ומשך הטעינה שלו, והוא מותאם למהירות הטעינה של הדף. סקריפטים של תוכן שפועלים ב-"document_idle" לא צריכים להאזין לאירוע window.onload. ההפעלה שלהם מובטחת לאחר השלמת ה-DOM. אם סקריפט חייב לפעול אחרי window.onload, התוסף יכול לבדוק אם onload כבר הופעל באמצעות המאפיין document.readyState.