chrome.management

Descrizione

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

Autorizzazioni

management

Per utilizzare l'API Management, 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+

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 lancio (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.

  • attivato

    booleano

    Indica se è attualmente attivato o disattivato.

  • homepageUrl

    stringa facoltativa

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

  • hostPermissions

    string[]

    Restituisce un elenco di autorizzazioni basate sull'host.

  • icone

    IconInfo[] facoltativo

    Un elenco di informazioni sulle icone. Tieni presente che questo riflette solo ciò che è stato dichiarato nel manifest e l'immagine effettiva all'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 manifest relativa alle icone.

  • id

    stringa

    L'identificatore univoco dell'estensione.

  • installType

    ExtensionInstallType

    Modalità di installazione dell'estensione.

  • isApp

    booleano

    Obsoleto

    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

    booleano facoltativo

    Chrome 62+

    Indica se l'utente può attivare questa estensione. 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'articolo, 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 o versioni successive

    Il nome della versione di questa estensione, app o tema, se il manifest ne ha specificato uno.

ExtensionInstallType

Chrome 44+

Modalità di installazione dell'estensione. Uno dei seguenti admin: l'estensione è stata installata a causa di una policy amministrativa, development: l'estensione è stata caricata decompressa 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 altro modo.

Enum

"admin"

"development"

"normal"

"sideload"

"other"

ExtensionType

Chrome 44+

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 di questa immagine dell'icona. Per visualizzare una versione in scala di grigi dell'icona (per indicare, ad esempio, che un'estensione è disattivata), aggiungi ?grayscale=true all'URL.

LaunchType

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

Enum

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

Chrome 88+

Opzioni per la gestione della disinstallazione dell'estensione.

Proprietà

  • showConfirmDialog

    booleano facoltativo

    Indica se una finestra di dialogo di conferma della disinstallazione deve essere mostrata all'utente. 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()

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

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

Parametri

Resi

  • Promise<void>

    Chrome 88+ 
chrome.management.generateAppForLink(
  url: string,
  title: string,
): Promise<ExtensionInfo>

Genera un'app per un URL. Restituisce l'app di segnalibri 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.

Resi

get()

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

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

Parametri

Resi

getAll()

chrome.management.getAll(): Promise<ExtensionInfo[]>

Restituisce un elenco di informazioni su estensioni e app installate.

Resi

getPermissionWarningsById()

chrome.management.getPermissionWarningsById(
  id: string,
): 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.

Resi

  • Promise<string[]>

    Chrome 88+

getPermissionWarningsByManifest()

chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
): 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 "Gestione" nel manifest.

Parametri

  • manifestStr

    stringa

    Stringa JSON del manifest dell'estensione.

Resi

  • Promise<string[]>

    Chrome 88+

getSelf()

chrome.management.getSelf(): Promise<ExtensionInfo>

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

Resi

installReplacementWebApp()

Chrome 77+ 
chrome.management.installReplacementWebApp(): Promise<void>

Avvia l'app web di sostituzione specificata nel manifest. Chiede all'utente di installare l'app, se non è già installata.

Resi

  • Promise<void>

    Chrome 88+

launchApp()

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

Avvia un'applicazione.

Parametri

  • id

    stringa

    L'ID estensione dell'applicazione.

Resi

  • Promise<void>

    Chrome 88+

setEnabled()

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

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 onclick per un pulsante) e potrebbe presentare all'utente un'interfaccia utente di conferma nativa per prevenire abusi.

Parametri

  • id

    stringa

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

  • attivato

    booleano

    Indica se questo elemento deve essere attivato o disattivato.

Resi

  • Promise<void>

    Chrome 88+

setLaunchType()

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

Imposta il tipo di avvio di un'app.

Parametri

Resi

  • Promise<void>

    Chrome 88+

uninstall()

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

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

Parametri

Resi

  • Promise<void>

    Chrome 88+

uninstallSelf()

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

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

Parametri

Resi

  • Promise<void>

    Chrome 88+

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

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 è stata disinstallata.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (id: string) => void

    • id

      stringa