chrome.management

Vernieuwingsdatum: 2026-09-25 robots: noindex

Beschrijving

De chrome.management API biedt manieren om geïnstalleerde apps en extensies te beheren.

Toestemmingen

management

Manifest

Om de beheer-API te kunnen gebruiken, moet u de machtiging "management" in het extensiemanifest declareren. Bijvoorbeeld:

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

management.getPermissionWarningsByManifest , management.uninstallSelf en management.getSelf vereisen geen beheerdersrechten.

Soorten

ExtensionDisabledReason

Chrome 44+

Een reden waarom het item is uitgeschakeld.

Enum

"onbekend"

"permissions_increase"

ExtensionInfo

Informatie over een geïnstalleerde extensie, app of thema.

Eigenschappen

  • appLaunchUrl

    string optioneel

    De opstart-URL (alleen aanwezig voor apps).

  • beschikbareLaunchTypes

    LaunchType [] optioneel

    De momenteel beschikbare opstarttypen (alleen aanwezig voor apps).

  • beschrijving

    snaar

    De beschrijving van deze extensie, app of thema.

  • uitgeschakeldReden

    ExtensionDisabledReason (optioneel)

    Een reden waarom het item is uitgeschakeld.

  • ingeschakeld

    booleaans

    Of het nu is ingeschakeld of uitgeschakeld.

  • homepageUrl

    string optioneel

    De URL van de homepage van deze extensie, app of thema.

  • hostPermissions

    snaar[]

    Geeft een lijst met hostgebaseerde machtigingen terug.

  • pictogrammen

    IconInfo [] optioneel

    A list of icon information. Note that this just reflects what was declared in the manifest, and the actual image at that url may be larger or smaller than what was declared, so you might consider using explicit width and height attributes on img tags referencing these images. See the manifest documentation on icons for more details.

  • id

    snaar

    De unieke identificatiecode van de extensie.

  • installatietype

    ExtensieInstallatietype

    Hoe de uitbreiding is geïnstalleerd.

  • isApp

    booleaans

    Verouderd

    Gebruik alstublieft management.ExtensionInfo.type .

    Dit klopt als het om een ​​app gaat.

  • launchType

    LaunchType optioneel

    Het type app-lancering (alleen aanwezig voor apps).

  • kan uitschakelen

    booleaans

    Of deze extensie door de gebruiker kan worden uitgeschakeld of verwijderd.

  • kan inschakelen

    boolean optioneel

    Chrome 62+

    Of deze extensie door de gebruiker kan worden ingeschakeld. Dit wordt alleen geretourneerd voor extensies die niet zijn ingeschakeld.

  • naam

    snaar

    De naam van deze extensie, app of thema.

  • offlineIngeschakeld

    booleaans

    Of de extensie, app of het thema aangeeft dat het offline ondersteuning biedt.

  • optiesUrl

    snaar

    De URL van de optiepagina van het artikel, indien aanwezig.

  • toestemmingen

    snaar[]

    Geeft een lijst met API-gebaseerde machtigingen terug.

  • korte naam

    snaar

    Een korte versie van de naam van deze extensie, app of thema.

  • Het type van deze extensie, app of thema.

  • updateUrl

    string optioneel

    De update-URL van deze extensie, app of thema.

  • versie

    snaar

    De versie van deze extensie, app of thema.

  • versienaam

    string optioneel

    Chrome 50+

    De versienaam van deze extensie, app of thema, indien gespecificeerd in het manifest.

ExtensionInstallType

Chrome 44+

How the extension was installed. One of admin : The extension was installed because of an administrative policy, development : The extension was loaded unpacked in developer mode, normal : The extension was installed normally via a .crx file, sideload : The extension was installed by other software on the machine, other : The extension was installed by other means.

Enum

"beheerder"

"ontwikkeling"

"normaal"

"zijdelings laden"

"ander"

ExtensionType

Chrome 44+

Het type van deze extensie, app of thema.

Enum

"verlenging"

"gehoste_app"

"verpakte_app"

"legacy_packaged_app"

"thema"

"login_screen_extension"

IconInfo

Informatie over een pictogram dat hoort bij een extensie, app of thema.

Eigenschappen

  • maat

    nummer

    Een getal dat de breedte en hoogte van het pictogram aangeeft. Mogelijke waarden zijn (maar niet beperkt tot) 128, 48, 24 en 16.

  • URL

    snaar

    De URL voor deze pictogramafbeelding. Om een ​​grijsschaalversie van het pictogram weer te geven (bijvoorbeeld om aan te geven dat een extensie is uitgeschakeld), voegt u ?grayscale=true toe aan de URL.

LaunchType

Dit zijn alle mogelijke manieren om een ​​app te starten.

Enum

"OPEN_AS_NORLAR_TAB"

"OPEN_AS_FINNED_TAB"

"OPEN_AS_WINDOW"

"VOLLEDIG SCHERM OPENEN"

UninstallOptions

Chrome 88+

Opties voor het verwijderen van de extensie.

Eigenschappen

  • toonBevestigdialoog

    boolean optioneel

    Whether or not a confirm-uninstall dialog should prompt the user. Defaults to false for self uninstalls. If an extension uninstalls another extension, this parameter is ignored and the dialog is always shown.

Methoden

createAppShortcut()

Belofte
chrome.management.createAppShortcut(
  id: string,
  callback?: function,
): Promise<void>

Weergaveopties om snelkoppelingen voor een app te maken. Op Mac kunnen alleen snelkoppelingen voor meegeleverde apps worden gemaakt.

Parameters

  • id

    snaar

    Dit zou de ID moeten zijn van een app-item in management.ExtensionInfo .

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

Belofte
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
): Promise<ExtensionInfo>

Genereer een app voor een URL. Retourneert de gegenereerde bladwijzer-app.

Parameters

  • URL

    snaar

    De URL van een webpagina. De URL kan alleen de indeling "http" of "https" hebben.

  • titel

    snaar

    De titel van de gegenereerde app.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: ExtensionInfo) => void

Retourneert

  • Promise< ExtensionInfo >

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

get()

Belofte
chrome.management.get(
  id: string,
  callback?: function,
): Promise<ExtensionInfo>

Geeft informatie terug over de geïnstalleerde extensie, app of thema met de opgegeven ID.

Parameters

Retourneert

  • Promise< ExtensionInfo >

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getAll()

Belofte
chrome.management.getAll(
  callback?: function,
): Promise<ExtensionInfo[]>

Geeft een lijst weer met informatie over geïnstalleerde extensies en apps.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: ExtensionInfo[]) => void

Retourneert

  • Promise< ExtensionInfo []>

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getPermissionWarningsById()

Belofte
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
): Promise<string[]>

Geeft een lijst met waarschuwingen over machtigingen voor de opgegeven extensie-ID.

Parameters

  • id

    snaar

    De ID van een reeds geïnstalleerde extensie.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (permissionWarnings: string[]) => void

    • toestemmingswaarschuwingen

      snaar[]

Retourneert

  • Promise<string[]>

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getPermissionWarningsByManifest()

Belofte
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
): Promise<string[]>

Retourneert een lijst met waarschuwingen over machtigingen voor de opgegeven extensiemanifeststring. Opmerking: Deze functie kan worden gebruikt zonder de machtiging 'management' in het manifest aan te vragen.

Parameters

  • manifestStr

    snaar

    Extensiemanifest JSON-string.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (permissionWarnings: string[]) => void

    • toestemmingswaarschuwingen

      snaar[]

Retourneert

  • Promise<string[]>

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getSelf()

Belofte
chrome.management.getSelf(
  callback?: function,
): Promise<ExtensionInfo>

Geeft informatie terug over de aanroepende extensie, app of thema. Opmerking: Deze functie kan worden gebruikt zonder de 'management'-toestemming in het manifest aan te vragen.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: ExtensionInfo) => void

Retourneert

  • Promise< ExtensionInfo >

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

installReplacementWebApp()

Promise Chrome 77+
chrome.management.installReplacementWebApp(
  callback?: function,
): Promise<void>

Start de in het manifest gespecificeerde replacement_web_app. Vraagt ​​de gebruiker om de app te installeren als deze nog niet is geïnstalleerd.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

launchApp()

Belofte
chrome.management.launchApp(
  id: string,
  callback?: function,
): Promise<void>

Start een applicatie.

Parameters

  • id

    snaar

    De extensie-ID van de applicatie.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

setEnabled()

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

Enables or disables an app or extension. In most cases this function must be called in the context of a user gesture (eg an onclick handler for a button), and may present the user with a native confirmation UI as a way of preventing abuse.

Parameters

  • id

    snaar

    Dit zou de ID moeten zijn van een item in management.ExtensionInfo .

  • ingeschakeld

    booleaans

    Of dit item in- of uitgeschakeld moet worden.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

setLaunchType()

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

Stel het opstarttype van een app in.

Parameters

  • id

    snaar

    Dit zou de ID moeten zijn van een app-item in management.ExtensionInfo .

  • launchType

    Lanceringstype

    The target launch type. Always check and make sure this launch type is in ExtensionInfo.availableLaunchTypes , because the available launch types vary on different platforms and configurations.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

uninstall()

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

Uninstalls a currently installed app or extension. Note: This function does not work in managed environments when the user is not allowed to uninstall the specified extension/app. If the uninstall fails (eg the user cancels the dialog) the promise will be rejected or the callback will be called with runtime.lastError set.

Parameters

  • id

    snaar

    Dit zou de ID moeten zijn van een item in management.ExtensionInfo .

  • opties

    Verwijderopties optioneel

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

uninstallSelf()

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

Uninstalls the calling extension. Note: This function can be used without requesting the 'management' permission in the manifest. This function does not work in managed environments when the user is not allowed to uninstall the specified extension/app.

Parameters

  • opties

    Verwijderopties optioneel

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 88+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

Evenementen

onDisabled

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

Wordt geactiveerd wanneer een app of extensie is uitgeschakeld.

Parameters

onEnabled

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

Wordt geactiveerd wanneer een app of extensie is ingeschakeld.

Parameters

onInstalled

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

Wordt geactiveerd wanneer een app of extensie is geïnstalleerd.

Parameters

onUninstalled

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

Wordt geactiveerd wanneer een app of extensie is verwijderd.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (id: string) => void

    • id

      snaar