chrome.management

refresh date: 2026-09-25 robots: noindex

תיאור

‫chrome.management API מספק דרכים לנהל אפליקציות ותוספים מותקנים.

הרשאות

management

מניפסט

כדי להשתמש ב-Management API, צריך להצהיר על ההרשאה "ניהול" בקובץ המניפסט של התוסף. לדוגמה:

{
  "name": "My extension",
  ...
  "permissions": [
    "management"
  ],
  ...
}

התפקידים management.getPermissionWarningsByManifest,‏ management.uninstallSelf ו-management.getSelf לא דורשים הרשאת ניהול.

סוגים

ExtensionDisabledReason

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

הסיבה לכך שהפריט מושבת.

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

"unknown"

"permissions_increase"

ExtensionInfo

מידע על תוסף, אפליקציה או עיצוב שהותקנו.

מאפיינים

• appLaunchUrl

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

  כתובת ה-URL להפעלה (מופיעה רק באפליקציות).

• availableLaunchTypes

  LaunchType[] אופציונלי

  סוגי ההפעלה שזמינים כרגע (מופיעים רק באפליקציות).

• תיאור

  מחרוזת

  התיאור של התוסף, האפליקציה או העיצוב.

• disabledReason

  ExtensionDisabledReason אופציונלי

  הסיבה לכך שהפריט מושבת.

• פעיל

  בוליאני

  אם היא מופעלת או מושבתת כרגע.

• homepageUrl

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

  כתובת ה-URL של דף הבית של התוסף, האפליקציה או העיצוב.

• hostPermissions

  string[]‎

  הפונקציה מחזירה רשימה של הרשאות שמבוססות על מארח.

• סמלים

  IconInfo[] אופציונלי

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

• id [מזהה]

  מחרוזת

  המזהה הייחודי של התוסף.

• installType

  ExtensionInstallType

  איך התוסף הותקן.

• isApp

  בוליאני

  הוצא משימוש

  צריך להשתמש ב-management.ExtensionInfo.type.

  ‫True אם מדובר באפליקציה.

• launchType

  LaunchType אופציונלי

  סוג ההפעלה של האפליקציה (מופיע רק באפליקציות).

• mayDisable

  בוליאני

  אם המשתמש יכול להשבית או להסיר את התוסף הזה.

• mayEnable

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

  Chrome 62 ואילך

  האם המשתמש יכול להפעיל את התוסף הזה. הערך הזה מוחזר רק לתוספים שלא מופעלים.

• שם

  מחרוזת

  השם של התוסף, האפליקציה או העיצוב.

• offlineEnabled

  בוליאני

  אם התוסף, האפליקציה או העיצוב מצהירים על תמיכה במצב אופליין.

• optionsUrl

  מחרוזת

  כתובת ה-URL של דף האפשרויות של הפריט, אם יש כזה.

• permissions

  string[]‎

  מחזירה רשימה של הרשאות שמבוססות על API.

• shortName

  מחרוזת

  גרסה קצרה של השם של התוסף, האפליקציה או העיצוב.

• סוג

  ExtensionType

  הסוג של התוסף, האפליקציה או העיצוב.

• updateUrl

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

  כתובת ה-URL לעדכון של התוסף, האפליקציה או העיצוב.

• גרסה

  מחרוזת

  הגרסה של התוסף, האפליקציה או העיצוב.

• versionName

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

  Chrome 50 ומעלה

  שם הגרסה של התוסף, האפליקציה או העיצוב, אם צוין במניפסט.

ExtensionInstallType

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

איך התוסף הותקן. אחד מהערכים הבאים: admin: התוסף הותקן בגלל מדיניות ניהולית, development: התוסף נטען כשהוא לא ארוז במצב פיתוח, normal: התוסף הותקן באופן רגיל באמצעות קובץ ‎ .crx, sideload: התוסף הותקן על ידי תוכנה אחרת במחשב, other: התוסף הותקן באמצעים אחרים.

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

"admin"

"development"

"normal"

"sideload"

"other"

ExtensionType

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

הסוג של התוסף, האפליקציה או העיצוב.

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

"extension"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"login_screen_extension"

IconInfo

מידע על סמל ששייך לתוסף, לאפליקציה או לעיצוב.

מאפיינים

• size

  number

  מספר שמייצג את הרוחב והגובה של הסמל. הערכים האפשריים כוללים, בין היתר, את 128, 48, 24 ו-16.

• url

  מחרוזת

  כתובת ה-URL של תמונת הסמל. כדי להציג גרסה של הסמל בגווני אפור (למשל, כדי לציין שתוסף מושבת), מוסיפים ?grayscale=true לכתובת ה-URL.

LaunchType

אלה כל סוגי ההפעלה האפשריים של האפליקציה.

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

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

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

אפשרויות לטיפול בהסרת התוסף.

מאפיינים

• showConfirmDialog

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

  אם תוצג למשתמש תיבת דו-שיח לאישור ההסרה. ברירת המחדל היא false להסרות עצמיות. אם תוסף מסיר תוסף אחר, המערכת מתעלמת מהפרמטר הזה ותיבת הדו-שיח תמיד מוצגת.

Methods

createAppShortcut()

Promise

chrome.management.createAppShortcut(
  id: string,
  callback?: function,
): Promise<void>

הצגת אפשרויות ליצירת קיצורי דרך לאפליקציה. ב-Mac, אפשר ליצור רק קיצורי דרך לאפליקציות ארוזות.

פרמטרים

• id [מזהה]

  מחרוזת

  זה צריך להיות המזהה של פריט באפליקציה של management.ExtensionInfo.

• callback

  function optional

  הפרמטר callback נראה כך:

  () => void

החזרות

• Promise<void>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

generateAppForLink()

Promise

chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
): Promise<ExtensionInfo>

ליצור אפליקציה לכתובת URL. הפונקציה מחזירה את האפליקציה של הסימניות שנוצרה.

פרמטרים

• url

  מחרוזת

  כתובת ה-URL של דף אינטרנט. הסכימה של כתובת ה-URL יכולה להיות רק "http" או "https".

• title

  מחרוזת

  השם של האפליקציה שנוצרה.

• callback

  function optional

  הפרמטר callback נראה כך:

  (result: ExtensionInfo) => void

  • תוצאה

    ExtensionInfo

החזרות

• Promise<ExtensionInfo>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

get()

Promise

chrome.management.get(
  id: string,
  callback?: function,
): Promise<ExtensionInfo>

הפונקציה מחזירה מידע על התוסף, האפליקציה או העיצוב המותקנים עם המזהה שצוין.

פרמטרים

• id [מזהה]

  מחרוזת

  המזהה של פריט מ-management.ExtensionInfo.

• callback

  function optional

  הפרמטר callback נראה כך:

  (result: ExtensionInfo) => void

  • תוצאה

    ExtensionInfo

החזרות

• Promise<ExtensionInfo>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

getAll()

Promise

chrome.management.getAll(
  callback?: function,
): Promise<ExtensionInfo[]>

מחזירה רשימה של מידע על תוספים ואפליקציות מותקנים.

פרמטרים

• callback

  function optional

  הפרמטר callback נראה כך:

  (result: ExtensionInfo[]) => void

  • תוצאה

    ExtensionInfo[]

החזרות

• Promise<ExtensionInfo[]>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

getPermissionWarningsById()

Promise

chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
): Promise<string[]>

מחזירה רשימה של אזהרות לגבי הרשאות למזהה התוסף שצוין.

פרמטרים

• id [מזהה]

  מחרוזת

  המזהה של תוסף שכבר מותקן.

• callback

  function optional

  הפרמטר callback נראה כך:

  (permissionWarnings: string[]) => void

  • permissionWarnings

    string[]‎

החזרות

• Promise<string[]>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

getPermissionWarningsByManifest()

Promise

chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
): Promise<string[]>

מחזירה רשימה של אזהרות לגבי הרשאות למחרוזת המניפסט של התוסף שצוין. הערה: אפשר להשתמש בפונקציה הזו בלי לבקש את ההרשאה "ניהול" במניפסט.

פרמטרים

• manifestStr

  מחרוזת

  מחרוזת JSON של מניפסט התוסף.

• callback

  function optional

  הפרמטר callback נראה כך:

  (permissionWarnings: string[]) => void

  • permissionWarnings

    string[]‎

החזרות

• Promise<string[]>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

getSelf()

Promise

chrome.management.getSelf(
  callback?: function,
): Promise<ExtensionInfo>

מחזירה מידע על התוסף, האפליקציה או העיצוב שקוראים לה. הערה: אפשר להשתמש בפונקציה הזו בלי לבקש את ההרשאה "ניהול" במניפסט.

פרמטרים

• callback

  function optional

  הפרמטר callback נראה כך:

  (result: ExtensionInfo) => void

  • תוצאה

    ExtensionInfo

החזרות

• Promise<ExtensionInfo>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

installReplacementWebApp()

Promise Chrome 77 ואילך

chrome.management.installReplacementWebApp(
  callback?: function,
): Promise<void>

הפעלת replacement_web_app שצוינה במניפסט. אם האפליקציה לא מותקנת, המשתמש מתבקש להתקין אותה.

פרמטרים

• callback

  function optional

  הפרמטר callback נראה כך:

  () => void

החזרות

• Promise<void>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

launchApp()

Promise

chrome.management.launchApp(
  id: string,
  callback?: function,
): Promise<void>

מפעילה אפליקציה.

פרמטרים

• id [מזהה]

  מחרוזת

  מזהה התוסף של האפליקציה.

• callback

  function optional

  הפרמטר callback נראה כך:

  () => void

החזרות

• Promise<void>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

setEnabled()

Promise

chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
): Promise<void>

הפעלה או השבתה של אפליקציה או תוסף. ברוב המקרים, צריך לקרוא לפונקציה הזו בהקשר של תנועה של המשתמש (למשל, handler של onclick ללחצן), והיא עשויה להציג למשתמש ממשק משתמש מקורי לאישור כדי למנוע ניצול לרעה.

פרמטרים

• id [מזהה]

  מחרוזת

  זה צריך להיות המזהה של פריט מ-management.ExtensionInfo.

• פעיל

  בוליאני

  אם הפריט הזה צריך להיות מופעל או מושבת.

• callback

  function optional

  הפרמטר callback נראה כך:

  () => void

החזרות

• Promise<void>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

setLaunchType()

Promise

chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
): Promise<void>

הגדרת סוג ההפעלה של אפליקציה.

פרמטרים

• id [מזהה]

  מחרוזת

  זה צריך להיות המזהה של פריט באפליקציה של management.ExtensionInfo.

• launchType

  LaunchType

  סוג ההשקה של היעד. חשוב תמיד לבדוק ולוודא שסוג ההפעלה הזה הוא ExtensionInfo.availableLaunchTypes, כי סוגי ההפעלה הזמינים משתנים בהתאם לפלטפורמות ולהגדרות האישיות השונות.

• callback

  function optional

  הפרמטר callback נראה כך:

  () => void

החזרות

• Promise<void>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

uninstall()

Promise

chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

הסרת אפליקציה או תוסף שמותקנים כרגע. הערה: הפונקציה הזו לא פועלת בסביבות מנוהלות כשלמשתמש אין הרשאה להסיר את התוסף או האפליקציה שצוינו. אם ההסרה נכשלת (למשל, המשתמש מבטל את תיבת הדו-שיח), ההבטחה תידחה או שהקריאה החוזרת תופעל עם הגדרת runtime.lastError.

פרמטרים

• id [מזהה]

  מחרוזת

  זה צריך להיות המזהה של פריט מ-management.ExtensionInfo.

• אפשרויות

  ‫UninstallOptions אופציונלי

• callback

  function optional

  הפרמטר callback נראה כך:

  () => void

החזרות

• Promise<void>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

uninstallSelf()

Promise

chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

הסרת תוסף השיחות. הערה: אפשר להשתמש בפונקציה הזו בלי לבקש את ההרשאה "ניהול" במניפסט. הפונקציה הזו לא פועלת בסביבות מנוהלות כשלמשתמש אין הרשאה להסיר את התוסף או האפליקציה שצוינו.

פרמטרים

• אפשרויות

  ‫UninstallOptions אופציונלי

• callback

  function optional

  הפרמטר callback נראה כך:

  () => void

החזרות

• Promise<void>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

אירועים

onDisabled

chrome.management.onDisabled.addListener(
  callback: function,
)

מופעל כשאפליקציה או תוסף מושבתים.

פרמטרים

• callback

  פונקציה

  הפרמטר callback נראה כך:

  (info: ExtensionInfo) => void

  • מידע

    ExtensionInfo

onEnabled

chrome.management.onEnabled.addListener(
  callback: function,
)

מופעל כשמפעילים אפליקציה או תוסף.

פרמטרים

• callback

  פונקציה

  הפרמטר callback נראה כך:

  (info: ExtensionInfo) => void

  • מידע

    ExtensionInfo

onInstalled

chrome.management.onInstalled.addListener(
  callback: function,
)

מופעל כשמתקינים אפליקציה או תוסף.

פרמטרים

• callback

  פונקציה

  הפרמטר callback נראה כך:

  (info: ExtensionInfo) => void

  • מידע

    ExtensionInfo

onUninstalled

chrome.management.onUninstalled.addListener(
  callback: function,
)

מופעל כשמסירים אפליקציה או תוסף.

פרמטרים

• callback

  פונקציה

  הפרמטר callback נראה כך:

  (id: string) => void

  • id [מזהה]

    מחרוזת