chrome.management

תאריך הרענון: 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 ואילך

הסיבה להשבתת הפריט.

ספירה

‫unknown

‫"permissions_increase"

ExtensionInfo

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

מאפיינים

  • appLaunchUrl

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

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

  • availableLaunchTypes

    ‫LaunchType[] optional

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

  • תיאור

    מחרוזת

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

  • disabledReason

    ‫ExtensionDisabledReason אופציונלי

    הסיבה להשבתת הפריט.

  • פעיל

    בוליאני

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

  • homepageUrl

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

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

  • hostPermissions

    string[]

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

  • סמלים

    ‫IconInfo[] optional

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

  • id [מזהה]

    מחרוזת

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

  • installType

    ExtensionInstallType

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

  • isApp

    בוליאני

    הוצא משימוש

    במקומה יש להשתמש בmanagement.ExtensionInfo.type.

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

  • launchType

    ‫LaunchType אופציונלי

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

  • mayDisable

    בוליאני

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

  • mayEnable

    ‫boolean אופציונלי

    ‫Chrome 62 ואילך

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

  • שם

    מחרוזת

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

  • offlineEnabled

    בוליאני

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

  • optionsUrl

    מחרוזת

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

  • permissions

    string[]

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

  • shortName

    מחרוזת

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

  • סוג

    ExtensionType

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

  • updateUrl

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

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

  • גרסה

    מחרוזת

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

  • versionName

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

    ‫Chrome 50 ואילך

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

ExtensionInstallType

‫Chrome 44 ואילך

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

ספירה

‫'admin'

‫'development'

‫'normal'

"העברה צדדית"

'אחר'

ExtensionType

‫Chrome 44 ואילך

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

ספירה

'תוסף'

"hosted_app"

‫"packaged_app"

"legacy_packaged_app"

‫"theme"

‫"login_screen_extension"

IconInfo

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

מאפיינים

  • size

    number

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

  • url

    מחרוזת

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

LaunchType

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

ספירה

‫"OPEN_AS_REGULAR_TAB"

‪"OPEN_AS_PINNED_TAB"

‫"OPEN_AS_WINDOW"

‫"OPEN_FULL_SCREEN"

UninstallOptions

‫Chrome 88 ואילך

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

מאפיינים

  • showConfirmDialog

    ‫boolean אופציונלי

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

Methods

createAppShortcut()

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

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

פרמטרים

  • id [מזהה]

    מחרוזת

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

  • callback

    פונקציה אופציונלית

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

    () => void

החזרות

  • Promise<void>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

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

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

פרמטרים

  • url

    מחרוזת

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

  • title

    מחרוזת

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

  • callback

    פונקציה אופציונלית

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

    (result: ExtensionInfo) => void

החזרות

  • Promise<ExtensionInfo>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

get()

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

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

פרמטרים

החזרות

  • Promise<ExtensionInfo>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

getAll()

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

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

פרמטרים

  • callback

    פונקציה אופציונלית

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

    (result: ExtensionInfo[]) => void

החזרות

  • Promise<ExtensionInfo[]>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

getPermissionWarningsById()

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

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

פרמטרים

  • id [מזהה]

    מחרוזת

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

  • callback

    פונקציה אופציונלית

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      string[]

החזרות

  • Promise<string[]>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

getPermissionWarningsByManifest()

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

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

פרמטרים

  • manifestStr

    מחרוזת

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

  • callback

    פונקציה אופציונלית

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      string[]

החזרות

  • Promise<string[]>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

getSelf()

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

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

פרמטרים

  • callback

    פונקציה אופציונלית

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

    (result: ExtensionInfo) => void

החזרות

  • Promise<ExtensionInfo>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

installReplacementWebApp()

Promise Chrome 77 ואילך 
chrome.management.installReplacementWebApp(
  callback?: function,
): Promise<void>

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

פרמטרים

  • callback

    פונקציה אופציונלית

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

    () => void

החזרות

  • Promise<void>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

launchApp()

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

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

פרמטרים

  • id [מזהה]

    מחרוזת

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

  • callback

    פונקציה אופציונלית

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

    () => void

החזרות

  • Promise<void>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

setEnabled()

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

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

פרמטרים

  • id [מזהה]

    מחרוזת

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

  • פעיל

    בוליאני

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

  • callback

    פונקציה אופציונלית

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

    () => void

החזרות

  • Promise<void>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

setLaunchType()

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

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

פרמטרים

  • id [מזהה]

    מחרוזת

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

  • launchType

    LaunchType

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

  • callback

    פונקציה אופציונלית

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

    () => void

החזרות

  • Promise<void>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

uninstall()

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

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

פרמטרים

  • id [מזהה]

    מחרוזת

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

  • options

    ‫UninstallOptions אופציונלי

  • callback

    פונקציה אופציונלית

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

    () => void

החזרות

  • Promise<void>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

uninstallSelf()

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

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

פרמטרים

  • options

    ‫UninstallOptions אופציונלי

  • callback

    פונקציה אופציונלית

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

    () => void

החזרות

  • Promise<void>

    ‫Chrome 88 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

אירועים

onDisabled

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

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

פרמטרים

onEnabled

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

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

פרמטרים

onInstalled

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

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

פרמטרים

onUninstalled

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

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

פרמטרים

  • callback

    פונקציה

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

    (id: string) => void

    • id [מזהה]

      מחרוזת