chrome.extensionTypes

refresh date: 2026-09-25 robots: noindex

תיאור

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

סוגים

ColorArray

‫Chrome מגרסה 139 ואילך

סוג

[מספר, מספר, מספר, מספר]

CSSOrigin

Chrome 66 ואילך

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

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

"author"

"user"

DeleteInjectionDetails

‫Chrome מגרסה 87 ואילך

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

מאפיינים

• allFrames

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

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

• קוד

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

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

• cssOrigin

  CSSOrigin אופציונלי

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

• קובץ

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

  קובץ CSS להסרה.

• frameId

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

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

• matchAboutBlank

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

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

DocumentLifecycle

‫Chrome מגרסה 106 ואילך

מחזור החיים של המסמך ב-frame.

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

"רינדור מראש"

"active"

"cached"

"pending_deletion"

ExecutionWorld

‫Chrome מגרסה 111 ואילך

העולם של JavaScript שבו הסקריפט יפעל. העולם יכול להיות עולם מבודד שייחודי לתוסף הזה, העולם הראשי של ה-DOM שמשותף עם ה-JavaScript של הדף, או עולם של סקריפטים של משתמשים שזמין רק לסקריפטים שרשומים ב-User Scripts 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

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

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

• קוד

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

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

  אזהרה: צריך להיזהר כשמשתמשים בפרמטר code. שימוש שגוי ב-API הזה עלול לחשוף את התוסף להתקפות פרצת אבטחה XSS‏ (cross-site scripting).

• cssOrigin

  CSSOrigin אופציונלי

  Chrome 66 ואילך

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

• קובץ

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

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

• frameId

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

  Chrome 50 ומעלה

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

• matchAboutBlank

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

  אם הערך של 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.