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
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
Modalità di installazione dell'estensione.
-
isApp
boolean
DeprecatoUtilizza
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 successiveIndica 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.
-
tipo
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 successiveIl nome della versione di questa estensione, app o tema, se specificato nel file manifest.
ExtensionInstallType
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
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
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()
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 successiveLe 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.
generateAppForLink()
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
-
risultato
-
Ritorni
-
Promise<ExtensionInfo>
Chrome 88 e versioni successiveLe 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()
chrome.management.get(
id: string,
callback?: function,
)
Restituisce informazioni sull'estensione, sull'app o sul tema installata con l'ID specificato.
Parametri
-
id
stringa
L'ID di un elemento di
management.ExtensionInfo
. -
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(result: ExtensionInfo) => void
-
risultato
-
Ritorni
-
Promise<ExtensionInfo>
Chrome 88 e versioni successiveLe 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()
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
-
risultato
-
Ritorni
-
Promise<ExtensionInfo[]>
Chrome 88 e versioni successiveLe 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()
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 successiveLe 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()
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 successiveLe 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()
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
-
risultato
-
Ritorni
-
Promise<ExtensionInfo>
Chrome 88 e versioni successiveLe 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()
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 successiveLe 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()
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 successiveLe 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()
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 successiveLe 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()
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
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 successiveLe 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()
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
-
id
stringa
Deve essere l'ID di un articolo di
management.ExtensionInfo
. -
opzioni
UninstallOptions opzionale
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 88 e versioni successiveLe 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()
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 successiveLe 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
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(info: ExtensionInfo) => void
-
informazioni
-
onEnabled
chrome.management.onEnabled.addListener(
callback: function,
)
Attivato quando è stata abilitata un'app o un'estensione.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(info: ExtensionInfo) => void
-
informazioni
-
onInstalled
chrome.management.onInstalled.addListener(
callback: function,
)
Attivato quando viene installata un'app o un'estensione.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(info: ExtensionInfo) => void
-
informazioni
-
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
-