chrome.management

Descrizione

L'API chrome.management fornisce modi per gestire l'elenco di estensioni/app installate e in esecuzione. È particolarmente utile per le estensioni che sostituiscono la pagina Nuova scheda integrata.

Autorizzazioni

management

Per utilizzare l'API di gestione, devi dichiarare l'autorizzazione di "gestione" nel manifest delle estensioni. 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

ExtensionInfo

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

Proprietà

  • appLaunchUrl

    stringa facoltativo

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

  • availableLaunchTypes

    LaunchType[] facoltativo

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

  • descrizione

    stringa

    La descrizione di questa estensione, app o tema.

  • disabledReason

    ExtensionDisabledReason Facoltativo

    Un motivo per cui l'elemento è disattivato.

  • abilitata

    boolean

    Se è attualmente attivata o disattivata.

  • homepageUrl

    stringa facoltativo

    L'URL della home page dell'estensione, dell'app o del tema.

  • hostPermissions

    stringa[]

    Restituisce un elenco di autorizzazioni basate sull'host.

  • icone

    IconInfo[] facoltativo

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

  • id

    stringa

    L'identificatore univoco dell'estensione.

  • installType

    ExtensionInstallType

    Modalità di installazione dell'estensione.

  • isApp

    boolean

    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

    boolean

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

  • mayEnable

    booleano facoltativo

    Chrome 62 e versioni successive

    Indica se questa estensione può essere attivata dall'utente. Viene restituito solo per le estensioni non attive.

  • nome

    stringa

    Il nome dell'estensione, dell'app o del tema.

  • offlineEnabled

    boolean

    Indica 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

    stringa[]

    Restituisce un elenco di autorizzazioni basate su API.

  • shortName

    stringa

    Una versione breve del nome dell'estensione, dell'app o del tema.

  • Il tipo di estensione, app o tema.

  • updateUrl

    stringa facoltativo

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

  • versione

    stringa

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

  • versionName

    stringa facoltativo

    Chrome 50 e versioni successive

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

ExtensionInstallType

Chrome 44 e versioni successive

Modalità di installazione dell'estensione. Uno di admin: l'estensione è stata installata a causa di un criterio amministrativo, 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 in altri modi.

Enum

"sideload"

ExtensionType

Chrome 44 e versioni successive

Il tipo di estensione, app o tema.

Enum

"hosted_app"

"packaged_app"

"login_screen_extension"

IconInfo

Informazioni su un'icona appartenente a un'estensione, a un'app o a 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 di questa 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 tipi di lancio di app possibili.

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

    booleano facoltativo

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

Metodi

createAppShortcut()

Promessa 
chrome.management.createAppShortcut(
  id: string,
  callback?: function,
)

Visualizza le opzioni per creare scorciatoie per un'app. Su Mac è possibile creare solo scorciatoie app in pacchetto.

Parametri

  • id

    stringa

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

Promessa 
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
)

Generare un'app per un URL. Restituisce l'app di preferiti generata.

Parametri

  • url

    stringa

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

  • title

    stringa

    Il titolo dell'app generata.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: ExtensionInfo)=>void

Ritorni

  • Promise<ExtensionInfo>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

get()

Promessa 
chrome.management.get(
  id: string,
  callback?: function,
)

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

Parametri

Ritorni

  • Promise<ExtensionInfo>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

getAll()

Promessa 
chrome.management.getAll(
  callback?: function,
)

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

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: ExtensionInfo[])=>void

Ritorni

  • Promise<ExtensionInfo[]>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

getPermissionWarningsById()

Promessa 
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
)

Restituisce un elenco di avvisi di autorizzazione per l'ID estensione specificato.

Parametri

  • id

    stringa

    L'ID di un'estensione già installata.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (permissionWarnings: string[])=>void

    • permissionWarnings

      stringa[]

Ritorni

  • Promessa<string[]>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

getPermissionWarningsByManifest()

Promessa 
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
)

Restituisce un elenco di avvisi di autorizzazione per la stringa manifest delle estensioni specificata. Nota: questa funzione può essere utilizzata senza richiedere l'autorizzazione di "gestione" nel manifest.

Parametri

  • manifestStr

    stringa

    Stringa JSON del file manifest dell'estensione.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (permissionWarnings: string[])=>void

    • permissionWarnings

      stringa[]

Ritorni

  • Promessa<string[]>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

getSelf()

Promessa 
chrome.management.getSelf(
  callback?: function,
)

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

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: ExtensionInfo)=>void

Ritorni

  • Promise<ExtensionInfo>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

installReplacementWebApp()

Promessa Chrome 77 e versioni successive 
chrome.management.installReplacementWebApp(
  callback?: function,
)

Avvia l'elemento sostitutivo_web_app specificato nel file manifest. Chiede all'utente di eseguire l'installazione se non è già installata.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

launchApp()

Promessa 
chrome.management.launchApp(
  id: string,
  callback?: function,
)

Avvia un'applicazione.

Parametri

  • id

    stringa

    L'ID estensione dell'applicazione.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

setEnabled()

Promessa 
chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
)

Attiva o disattiva un'app o un'estensione. Nella maggior parte dei casi questa funzione deve essere chiamata nel contesto di un gesto dell'utente (ad esempio, un gestore di clic per un pulsante) e può presentare all'utente un'interfaccia utente di conferma nativa per prevenire gli abusi.

Parametri

  • id

    stringa

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

  • abilitata

    boolean

    Indica se questo elemento deve essere attivato o disattivato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

setLaunchType()

Promessa 
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
)

Imposta il tipo di avvio di un'app.

Parametri

  • id

    stringa

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

  • launchType

    LaunchType

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

uninstall()

Promessa 
chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
)

Disinstalla un'app o un'estensione attualmente installata. Nota: questa funzione non funziona negli ambienti gestiti quando l'utente non può 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

Ritorni

  • Promise<void>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

uninstallSelf()

Promessa 
chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
)

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

Parametri

  • opzioni

    UninstallOptions opzionale

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 88 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

Eventi

onDisabled

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

Attivato quando un'app o un'estensione viene disattivata.

Parametri

onEnabled

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

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

Parametri

onInstalled

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

Attivato quando viene installata un'app o un'estensione.

Parametri

onUninstalled

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

Attivato quando un'app o un'estensione viene disinstallata.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (id: string)=>void

    • id

      stringa