chrome.extensionTypes

תאריך הרענון: 2026-09-25 robots: noindex

תיאור

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

סוגים

ColorArray

‫Chrome 139 ואילך

סוג

[number, number, number, number]

CSSOrigin

‫Chrome 66 ואילך

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

ספירה

‫"author"

‫'user'

DeleteInjectionDetails

‫Chrome 87 ואילך

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

מאפיינים

  • 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 ואילך

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

ספירה

‫prerender

'פעיל'

'cached'

‫pending_deletion

ExecutionWorld

‫Chrome 111 ואילך

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

ספירה

‫"ISOLATED"

‫"MAIN"

‫"USER_SCRIPT"

FrameType

‫Chrome 106 ואילך

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

ספירה

‫"outermost_frame"

‫"fenced_frame"

‫‎"sub_frame"

ImageDataType

‫Chrome 139 ואילך

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

סוג

ImageData

ImageDetails

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

מאפיינים

  • פורמט

    ‫ImageFormat אופציונלי

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

  • איכות

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

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

ImageFormat

‫Chrome 44 ואילך

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

ספירה

‫"jpeg"

‫'png'

InjectDetails

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

מאפיינים

  • 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:-frames. ערך ברירת המחדל הוא false.

  • runAt

    ‫RunAt אופציונלי

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

RunAt

‫Chrome 44 ואילך

המועד המוקדם ביותר שבו קוד ה-JavaScript או ה-CSS יוזרק לכרטיסייה.

ספירה

‫document_start
הסקריפט מוזרק אחרי קבצים מ-CSS, אבל לפני בנייה של DOM אחר או הפעלה של סקריפט אחר.

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

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