chrome.management

Descrizione

L'API chrome.management consente di gestire le app e le estensioni installate.

Autorizzazioni

management

Devi dichiarare il valore "management" nel manifest dell'estensione per utilizzare la gestione tramite Google Cloud CLI o tramite l'API Compute Engine. Ad esempio:

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

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

Tipi

ExtensionDisabledReason

Chrome 44 e versioni successive .

Un motivo per cui l'elemento è disattivato.

Enum

"sconosciuto"

"permissions_increase"

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

    booleano

    Se è attualmente abilitato o disabilitato.

  • homepageUrl

    stringa facoltativo

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

  • hostPermissions

    stringa[]

    Restituisce un elenco di autorizzazioni basate su host.

  • icone

    IconInfo[] facoltativo

    Un elenco di informazioni sulle icone. Tieni presente che ciò riflette solo ciò che è stato dichiarato nel file manifest e che l'immagine effettiva in tale URL potrebbe essere più grande o più piccola di quella dichiarata, 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 relativa ai file manifest sulle icone.

  • id

    stringa

    L'identificatore univoco dell'estensione.

  • installType

    ExtensionInstallType

    Modalità di installazione dell'estensione.

  • isApp

    booleano

    Obsoleta

    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 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 attivate.

  • nome

    stringa

    Il nome di questa estensione, app o tema.

  • offlineEnabled

    booleano

    Indica se l'estensione, l'app o il tema dichiara che supporta 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 di questa estensione, app o tema.

  • Il tipo di questa estensione, app o tema.

  • updateUrl

    stringa facoltativo

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

  • versione

    stringa

    La versione di questa estensione, app o tema.

  • versionName

    stringa facoltativo

    Chrome 50 e versioni successive .

    Il nome versione dell'estensione, dell'app o del 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

"amministratore"

"sviluppo"

"normale"

"sideload"

"altro"

ExtensionType

Chrome 44 e versioni successive .

Il tipo di questa estensione, app o tema.

Enum

"estensione"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"tema"

"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 di questa immagine 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 lanci di 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

    booleano facoltativo

    Indica se l'utente deve visualizzare o meno 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()

Promesso .
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 dell'app management.ExtensionInfo.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

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

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 facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: ExtensionInfo) => void

Resi

  • Promise&lt;ExtensionInfo&gt;

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

get()

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

Restituisce informazioni sull'estensione, l'app o il tema installati con l'ID specificato.

Parametri

Resi

  • Promise&lt;ExtensionInfo&gt;

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getAll()

Promesso .
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

Resi

  • Promise&lt;ExtensionInfo[]&gt;

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getPermissionWarningsById()

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

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 facoltativa

    Il parametro callback ha il seguente aspetto: 

    (permissionWarnings: string[]) => void

    • permissionWarnings

      stringa[]

Resi

  • Promise&lt;string[]&gt;

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getPermissionWarningsByManifest()

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

Restituisce un elenco di avvisi relativi alle autorizzazioni per la stringa manifest dell'estensione specificata. Nota: questa funzione può essere utilizzata senza richiedere l'autorizzazione "gestione" nel file 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[]

Resi

  • Promise&lt;string[]&gt;

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getSelf()

Promesso .
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 "gestione" nel file manifest.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: ExtensionInfo) => void

Resi

  • Promise&lt;ExtensionInfo&gt;

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

installReplacementWebApp()

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

Avvia il_ricambio_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

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

launchApp()

Promesso .
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

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

setEnabled()

Promesso .
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 richiamata nel contesto di un gesto dell'utente (ad es. un gestore clickserver per un pulsante) e potrebbe presentare all'utente un'interfaccia utente di conferma nativa come modo per evitare utilizzi illeciti.

Parametri

  • id

    stringa

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

  • abilitata

    booleano

    Indica se questo elemento deve essere attivato o disattivato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

setLaunchType()

Promesso .
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 dell'app management.ExtensionInfo.

  • launchType

    LaunchType

    Il tipo di lancio target. Assicurati sempre che questo tipo di lancio sia impostato su ExtensionInfo.availableLaunchTypes, perché i tipi di lancio disponibili variano in base a piattaforme e configurazioni diverse.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

uninstall()

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

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

Parametri

  • id

    stringa

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

  • opzioni

    UninstallOptions facoltativo

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

uninstallSelf()

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

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

Parametri

  • opzioni

    UninstallOptions facoltativo

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al 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 è stata attivata un'app o un'estensione.

Parametri

onInstalled

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

Attivato quando è stata 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