chrome.management

refresh date: 2026-09-25 robots: noindex

Descrizione

L'API chrome.management fornisce modi per gestire le app e le estensioni installate.

Autorizzazioni

management

Manifest

Per utilizzare l'API di gestione, devi dichiarare l'autorizzazione "management" nel manifest dell'estensione. Ad esempio:

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

management.getPermissionWarningsByManifest, management.uninstallSelf e management.getSelf non richiedono l'autorizzazione di gestione.

Tipi

ExtensionDisabledReason

Chrome 44 e versioni successive

Un motivo per cui l'elemento è disattivato.

Enum

"unknown"

"permissions_increase"

ExtensionInfo

Informazioni su un'estensione, un'app o un tema installati.

Proprietà

  • appLaunchUrl

    stringa facoltativa

    L'URL di avvio (presente solo per le app).

  • availableLaunchTypes

    LaunchType[] facoltativo

    I tipi di lancio attualmente disponibili (presenti solo per le app).

  • descrizione

    stringa

    La descrizione dell'estensione, dell'app o del tema.

  • disabledReason

    ExtensionDisabledReason facoltativo

    Un motivo per cui l'elemento è disattivato.

  • attivato

    booleano

    Se è attualmente attivata o disattivata.

  • homepageUrl

    stringa facoltativa

    L'URL della home page di questa estensione, app o tema.

  • hostPermissions

    string[]

    Restituisce un elenco di autorizzazioni basate sull'host.

  • icons

    IconInfo[] facoltativo

    Un elenco di informazioni sulle icone. Tieni presente che questo riflette solo ciò che è stato dichiarato nel manifest e l'immagine effettiva in quell'URL potrebbe essere più grande o più piccola di quanto dichiarato, quindi potresti prendere in considerazione l'utilizzo di attributi di larghezza e altezza espliciti nei tag img che fanno riferimento a queste immagini. Per ulteriori dettagli, consulta la documentazione del file manifest sulle icone.

  • id

    stringa

    L'identificatore univoco dell'estensione.

  • installType

    ExtensionInstallType

    La modalità di installazione dell'estensione.

  • isApp

    booleano

    Deprecato

    Utilizza management.ExtensionInfo.type.

    True se si tratta di un'app.

  • launchType

    LaunchType facoltativo

    Il tipo di avvio dell'app (presente solo per le app).

  • mayDisable

    booleano

    Indica se l'estensione può essere disattivata o disinstallata dall'utente.

  • mayEnable

    boolean facoltativo

    Chrome 62 e versioni successive

    Indica se questa estensione può essere attivata dall'utente. Questo valore viene restituito solo per le estensioni non attivate.

  • nome

    stringa

    Il nome di questa estensione, app o tema.

  • offlineEnabled

    booleano

    Se l'estensione, l'app o il tema dichiara di supportare la modalità offline.

  • optionsUrl

    stringa

    L'URL della pagina delle opzioni dell'elemento, se presente.

  • autorizzazioni

    string[]

    Restituisce un elenco di autorizzazioni basate su API.

  • shortName

    stringa

    Una versione breve del nome di questa estensione, app o tema.

  • Il tipo di estensione, app o tema.

  • updateUrl

    stringa facoltativa

    L'URL di aggiornamento di questa estensione, app o tema.

  • versione

    stringa

    La versione di questa estensione, app o tema.

  • versionName

    stringa facoltativa

    Chrome 50+

    Il nome della versione di questa estensione, app o tema, se specificato nel manifest.

ExtensionInstallType

Chrome 44 e versioni successive

La modalità di installazione dell'estensione. Uno dei seguenti valori: admin: l'estensione è stata installata in base a una policy amministrativa, development: l'estensione è stata caricata non pacchettizzata in modalità sviluppatore, normal: l'estensione è stata installata normalmente tramite un file .crx, sideload: l'estensione è stata installata da un altro software sul computer, other: l'estensione è stata installata con altri mezzi.

Enum

"admin"

"development"

"normal"

"sideload"

"other"

ExtensionType

Chrome 44 e versioni successive

Il tipo di estensione, app o tema.

Enum

"extension"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"login_screen_extension"

IconInfo

Informazioni su un'icona appartenente a un'estensione, un'app o un tema.

Proprietà

  • dimensioni

    numero

    Un numero che rappresenta la larghezza e l'altezza dell'icona. I valori probabili includono (a titolo esemplificativo) 128, 48, 24 e 16.

  • url

    stringa

    L'URL dell'immagine dell'icona. Per visualizzare una versione in scala di grigi dell'icona (ad esempio per indicare che un'estensione è disattivata), aggiungi ?grayscale=true all'URL.

LaunchType

Questi sono tutti i possibili tipi di avvio dell'app.

Enum

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

Chrome 88 e versioni successive

Opzioni per la gestione della disinstallazione dell'estensione.

Proprietà

  • showConfirmDialog

    boolean facoltativo

    Indica se all'utente deve essere mostrata o meno una finestra di dialogo di conferma della disinstallazione. Il valore predefinito è false per le disinstallazioni automatiche. Se un'estensione ne disinstalla un'altra, questo parametro viene ignorato e la finestra di dialogo viene sempre visualizzata.

Metodi

createAppShortcut()

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

Visualizza le opzioni per creare scorciatoie per un'app. Su Mac, è possibile creare solo scorciatoie per app pacchettizzate.

Parametri

  • id

    stringa

    Deve essere l'ID di un elemento dell'app di management.ExtensionInfo.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

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

Genera un'app per un URL. Restituisce l'app Preferiti generata.

Parametri

  • url

    stringa

    L'URL di una pagina web. Lo schema dell'URL può essere solo "http" o "https".

  • titolo

    stringa

    Il titolo dell'app generata.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: ExtensionInfo) => void

Resi

  • Promise<ExtensionInfo>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

get()

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

Restituisce informazioni sull'estensione, sull'app o sul tema installato con l'ID specificato.

Parametri

Resi

  • Promise<ExtensionInfo>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getAll()

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

Restituisce un elenco di informazioni sulle estensioni e sulle app installate.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: ExtensionInfo[]) => void

Resi

  • Promise<ExtensionInfo[]>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getPermissionWarningsById()

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

Restituisce un elenco di avvisi relativi alle autorizzazioni per l'ID estensione specificato.

Parametri

  • id

    stringa

    L'ID di un'estensione già installata.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (permissionWarnings: string[]) => void

    • permissionWarnings

      string[]

Resi

  • Promise<string[]>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getPermissionWarningsByManifest()

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

Restituisce un elenco di avvisi relativi alle autorizzazioni per la stringa del manifest dell'estensione specificata. Nota: questa funzione può essere utilizzata senza richiedere l'autorizzazione "management" nel manifest.

Parametri

  • manifestStr

    stringa

    Stringa JSON del manifest dell'estensione.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (permissionWarnings: string[]) => void

    • permissionWarnings

      string[]

Resi

  • Promise<string[]>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getSelf()

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

Restituisce informazioni sull'estensione, sull'app o sul tema chiamante. Nota: questa funzione può essere utilizzata senza richiedere l'autorizzazione "management" nel manifest.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: ExtensionInfo) => void

Resi

  • Promise<ExtensionInfo>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

installReplacementWebApp()

Promise Chrome 77 e versioni successive 
chrome.management.installReplacementWebApp(
  callback?: function,
): Promise<void>

Avvia l'app replacement_web_app specificata nel manifest. Chiede all'utente di installarla se non è già installata.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

launchApp()

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

Avvia un'applicazione.

Parametri

  • id

    stringa

    L'ID estensione dell'applicazione.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

setEnabled()

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

Attiva o disattiva un'app o un'estensione. Nella maggior parte dei casi, questa funzione deve essere chiamata nel contesto di un'attivazione dall'utente (ad es. un gestore onclick per un pulsante) e potrebbe presentare all'utente una UI di conferma nativa per impedire comportamenti illeciti.

Parametri

  • id

    stringa

    Deve essere l'ID di un elemento di management.ExtensionInfo.

  • attivato

    booleano

    Indica se questo elemento deve essere attivato o disattivato.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

setLaunchType()

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

Imposta il tipo di lancio di un'app.

Parametri

  • id

    stringa

    Deve essere l'ID di un elemento dell'app di management.ExtensionInfo.

  • launchType

    LaunchType

    Il tipo di lancio target. Controlla sempre che questo tipo di lancio sia in ExtensionInfo.availableLaunchTypes, perché i tipi di lancio disponibili variano a seconda delle piattaforme e delle configurazioni.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

uninstall()

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

Disinstalla un'app o un'estensione attualmente installata. Nota: questa funzione non è disponibile negli ambienti gestiti quando l'utente non è autorizzato a disinstallare l'estensione o l'app specificata. Se la disinstallazione non va a buon fine (ad esempio, l'utente annulla la finestra di dialogo), la promessa verrà rifiutata o il callback verrà chiamato con runtime.lastError impostato.

Parametri

  • id

    stringa

    Deve essere l'ID di un elemento di management.ExtensionInfo.

  • opzioni

    UninstallOptions facoltativo

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

uninstallSelf()

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

Disinstalla l'estensione di chiamata. Nota: questa funzione può essere utilizzata senza richiedere l'autorizzazione "management" nel manifest. Questa funzione non funziona negli ambienti gestiti quando l'utente non è autorizzato a disinstallare l'estensione o l'app specificata.

Parametri

  • opzioni

    UninstallOptions facoltativo

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 88 e versioni successive

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

Eventi

onDisabled

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

Attivato quando un'app o un'estensione è stata disattivata.

Parametri

onEnabled

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

Attivato quando un'app o un'estensione è stata attivata.

Parametri

onInstalled

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

Attivato quando un'app o un'estensione è stata installata.

Parametri

onUninstalled

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

Attivato quando un'app o un'estensione è stata disinstallata.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (id: string) => void

    • id

      stringa