chrome.management

Descrizione

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

Autorizzazioni

management

Manifest

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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 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 è 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