chrome.extensionTypes

תיאור

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

סוגים

ColorArray

‫Chrome 139+

סוג

[number, number, number, number]

CSSOrigin

‫Chrome 66 ואילך

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

Enum

‎"author"

‎"user"‎

DeleteInjectionDetails

‫Chrome 87 ואילך

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

מאפיינים

  • allFrames

    ‫boolean אופציונלי

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

  • קוד

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

    קוד ה-CSS שרוצים להסיר.

  • cssOrigin

    ‫CSSOrigin אופציונלי

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

  • קובץ

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

    קובץ ה-CSS שרוצים להסיר.

  • frameId

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

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

  • matchAboutBlank

    ‫boolean אופציונלי

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

DocumentLifecycle

‫Chrome 106 ואילך

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

Enum

‫"prerender"

‫'active'

‫"cached"

‫"pending_deletion"

ExecutionWorld

‫Chrome 111 ואילך

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

Enum

‫"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

‫Chrome 106 ואילך

סוג הפריימים.

Enum

‎"outermost_frame"

‪"fenced_frame"

‪"sub_frame"

ImageDataType

‫Chrome 139+

נתוני פיקסלים של תמונה. חייב להיות אובייקט ImageData, למשל מרכיב canvas.

סוג

ImageData

ImageDetails

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

מאפיינים

  • פורמט

    ‫ImageFormat אופציונלי

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

  • איכות

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

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

ImageFormat

‫Chrome 44 ואילך

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

Enum

‪"jpeg"

‪"png"

InjectDetails

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

מאפיינים

  • allFrames

    ‫boolean אופציונלי

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

  • קוד

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

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

    אזהרה: צריך להיזהר כשמשתמשים בפרמטר code. שימוש לא נכון עלול לחשוף את התוסף שלכם להתקפות cross site scripting

  • cssOrigin

    ‫CSSOrigin אופציונלי

    ‫Chrome 66 ואילך

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

  • קובץ

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

    קובץ JavaScript או CSS להזרקה.

  • frameId

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

    ‫Chrome 50 ואילך

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

  • matchAboutBlank

    ‫boolean אופציונלי

    אם matchAboutBlank הוא true, הקוד מוזרק גם למסגרות about:blank ו-about:srcdoc אם לתוסף יש גישה למסמך האב שלו. אי אפשר להוסיף קוד למסגרות about:-ברמה העליונה. ערך ברירת המחדל הוא 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.