browser.management

Opis

Interfejs API chrome.management umożliwia zarządzanie zainstalowanymi aplikacjami i rozszerzeniami.

Uprawnienia

management

Aby korzystać z interfejsu API zarządzania, musisz zadeklarować uprawnienie „zarządzanie” w pliku manifestu rozszerzenia. Na przykład:

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

management.getPermissionWarningsByManifest(), management.uninstallSelf() i management.getSelf() nie wymagają uprawnień do zarządzania.

Typy

ExtensionDisabledReason

Chrome 44 lub nowsza browser.* od Chrome 148

Powód, dla którego element jest wyłączony.

Typ wyliczeniowy

"unknown"

"permissions_increase"

ExtensionInfo

Informacje o zainstalowanym rozszerzeniu, aplikacji lub motywie.

Właściwości

  • appLaunchUrl

    ciąg znaków opcjonalny

    Adres URL uruchamiania (tylko w przypadku aplikacji).

  • availableLaunchTypes

    LaunchType[] opcjonalny

    Obecnie dostępne typy uruchamiania (tylko w przypadku aplikacji).

  • opis

    tekst

    Opis rozszerzenia, aplikacji lub motywu.

  • disabledReason

    ExtensionDisabledReason opcjonalne

    Powód, dla którego element jest wyłączony.

  • aktywne

    wartość logiczna

    czy jest obecnie włączona czy wyłączona;

  • homepageUrl

    ciąg znaków opcjonalny

    Adres URL strony głównej rozszerzenia, aplikacji lub motywu.

  • hostPermissions

    string[]

    Zwraca listę uprawnień opartych na hoście.

  • ikony

    IconInfo[] opcjonalny

    Lista informacji o ikonach. Pamiętaj, że odzwierciedla to tylko to, co zostało zadeklarowane w pliku manifestu, a rzeczywisty obraz pod tym adresem URL może być większy lub mniejszy niż zadeklarowany, więc możesz rozważyć użycie jawnych atrybutów szerokości i wysokości w tagach img odwołujących się do tych obrazów. Więcej informacji znajdziesz w dokumentacji dotyczącej ikon w pliku manifestu.

  • id

    tekst

    Unikalny identyfikator rozszerzenia.

  • installType

    ExtensionInstallType

    Sposób instalacji rozszerzenia.

  • isApp

    wartość logiczna

    Wycofane

    Użyj management.ExtensionInfo.type.

    Wartość True (Prawda), jeśli jest to aplikacja.

  • launchType

    LaunchType opcjonalny

    Typ uruchamiania aplikacji (tylko w przypadku aplikacji).

  • mayDisable

    wartość logiczna

    Określa, czy użytkownik może wyłączyć lub odinstalować to rozszerzenie.

  • mayEnable

    boolean opcjonalne

    Chrome 62 lub nowsza browser.* od Chrome 148

    Określa, czy użytkownik może włączyć to rozszerzenie. Ta wartość jest zwracana tylko w przypadku rozszerzeń, które nie są włączone.

  • nazwa

    tekst

    Nazwa rozszerzenia, aplikacji lub motywu.

  • offlineEnabled

    wartość logiczna

    Określa, czy rozszerzenie, aplikacja lub motyw deklaruje obsługę trybu offline.

  • optionsUrl

    tekst

    Adres URL strony opcji elementu, jeśli taka istnieje.

  • uprawnienia

    string[]

    Zwraca listę uprawnień opartych na interfejsie API.

  • shortName

    tekst

    Krótka wersja nazwy rozszerzenia, aplikacji lub motywu.

  • Typ rozszerzenia, aplikacji lub motywu.

  • updateUrl

    ciąg znaków opcjonalny

    Adres URL aktualizacji tego rozszerzenia, aplikacji lub motywu.

  • wersja

    tekst

    Wersja rozszerzenia, aplikacji lub motywu.

  • versionName

    ciąg znaków opcjonalny

    Chrome 50 lub nowsza browser.* od Chrome 148

    Nazwa wersji rozszerzenia, aplikacji lub motywu, jeśli została określona w pliku manifestu.

ExtensionInstallType

Chrome 44 lub nowsza browser.* od Chrome 148

Sposób instalacji rozszerzenia. Jedna z tych wartości: admin: rozszerzenie zostało zainstalowane zgodnie z zasadami administracyjnymi, development: rozszerzenie zostało wczytane w trybie programisty, normal: rozszerzenie zostało zainstalowane w zwykły sposób za pomocą pliku .crx, sideload: rozszerzenie zostało zainstalowane przez inne oprogramowanie na komputerze, other: rozszerzenie zostało zainstalowane w inny sposób.

Typ wyliczeniowy

"admin"

"development"

"normal"

"sideload"

"other"

ExtensionType

Chrome 44 lub nowsza browser.* od Chrome 148

Typ rozszerzenia, aplikacji lub motywu.

Typ wyliczeniowy

"extension"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"login_screen_extension"

IconInfo

Informacje o ikonie należącej do rozszerzenia, aplikacji lub motywu.

Właściwości

  • rozmiar

    liczba

    Liczba określająca szerokość i wysokość ikony. Możliwe wartości to m.in. 128, 48, 24 i 16.

  • URL

    tekst

    Adres URL obrazu ikony. Aby wyświetlić ikonę w odcieniach szarości (np. aby wskazać, że rozszerzenie jest wyłączone), dodaj do adresu URL ciąg ?grayscale=true.

LaunchType

To są wszystkie możliwe typy uruchamiania aplikacji.

Typ wyliczeniowy

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

Chrome 88 lub nowsza browser.* od Chrome 148

Opcje dotyczące sposobu odinstalowywania rozszerzenia.

Właściwości

  • showConfirmDialog

    boolean opcjonalne

    Określa, czy użytkownik powinien zobaczyć okno z prośbą o potwierdzenie odinstalowania. Wartość domyślna to fałsz w przypadku samodzielnego odinstalowywania. Jeśli rozszerzenie odinstaluje inne rozszerzenie, ten parametr zostanie zignorowany i zawsze będzie wyświetlane okno dialogowe.

Metody

createAppShortcut()

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

Wyświetl opcje tworzenia skrótów do aplikacji. Na Macu można tworzyć tylko skróty do aplikacji spakowanych.

Parametry

Zwroty

  • thought Promise<void>

    Chrome 88 lub nowsza browser.* od Chrome 148 
browser.management.generateAppForLink(
  url: string,
  title: string,
): Promise<ExtensionInfo>

Wygeneruj aplikację dla adresu URL. Zwraca wygenerowaną aplikację do obsługi zakładek.

Parametry

  • URL

    tekst

    Adres URL strony internetowej. Schemat adresu URL może być tylko „http” lub „https”.

  • tytuł

    tekst

    Tytuł wygenerowanej aplikacji.

Zwroty

  • Promise<ExtensionInfo>

    Chrome 88 lub nowsza browser.* od Chrome 148

get()

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

Zwraca informacje o zainstalowanym rozszerzeniu, aplikacji lub motywie o podanym identyfikatorze.

Parametry

Zwroty

  • Promise<ExtensionInfo>

    Chrome 88 lub nowsza browser.* od Chrome 148

getAll()

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

Zwraca listę informacji o zainstalowanych rozszerzeniach i aplikacjach.

Zwroty

  • Promise<ExtensionInfo[]>

    Chrome 88 lub nowsza browser.* od Chrome 148

getPermissionWarningsById()

browser.management.getPermissionWarningsById(
  id: string,
): Promise<string[]>

Zwraca listę ostrzeżeń dotyczących uprawnień dla danego identyfikatora rozszerzenia.

Parametry

  • id

    tekst

    Identyfikator zainstalowanego rozszerzenia.

Zwroty

  • Promise<string[]>

    Chrome 88 lub nowsza browser.* od Chrome 148

getPermissionWarningsByManifest()

browser.management.getPermissionWarningsByManifest(
  manifestStr: string,
): Promise<string[]>

Zwraca listę ostrzeżeń dotyczących uprawnień dla danego ciągu znaków manifestu rozszerzenia. Uwaga: tej funkcji można używać bez prośby o uprawnienie „management” w pliku manifestu.

Parametry

  • manifestStr

    tekst

    Ciąg JSON manifestu rozszerzenia.

Zwroty

  • Promise<string[]>

    Chrome 88 lub nowsza browser.* od Chrome 148

getSelf()

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

Zwraca informacje o wywołującym rozszerzeniu, aplikacji lub motywie. Uwaga: tej funkcji można używać bez prośby o uprawnienie „management” w pliku manifestu.

Zwroty

  • Promise<ExtensionInfo>

    Chrome 88 lub nowsza browser.* od Chrome 148

installReplacementWebApp()

Chrome 77 lub nowsza browser.* od Chrome 148 
browser.management.installReplacementWebApp(): Promise<void>

Uruchamia aplikację replacement_web_app określoną w pliku manifestu. Jeśli aplikacja nie jest zainstalowana, użytkownik zostanie poproszony o jej zainstalowanie.

Zwroty

  • thought Promise<void>

    Chrome 88 lub nowsza browser.* od Chrome 148

launchApp()

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

Uruchamia aplikację.

Parametry

  • id

    tekst

    Identyfikator rozszerzenia aplikacji.

Zwroty

  • thought Promise<void>

    Chrome 88 lub nowsza browser.* od Chrome 148

setEnabled()

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

Włącza lub wyłącza aplikację bądź rozszerzenie. W większości przypadków tę funkcję należy wywołać w kontekście gestu użytkownika (np.modułu obsługi onclick przycisku). Może ona wyświetlić użytkownikowi natywny interfejs potwierdzenia, aby zapobiec nadużyciom.

Parametry

  • id

    tekst

    Powinien to być identyfikator elementu management.ExtensionInfo.

  • aktywne

    wartość logiczna

    Wskazuje, czy ten element powinien być włączony czy wyłączony.

Zwroty

  • thought Promise<void>

    Chrome 88 lub nowsza browser.* od Chrome 148

setLaunchType()

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

Ustaw typ uruchamiania aplikacji.

Parametry

Zwroty

  • thought Promise<void>

    Chrome 88 lub nowsza browser.* od Chrome 148

uninstall()

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

Odinstalowuje obecnie zainstalowaną aplikację lub rozszerzenie. Uwaga: ta funkcja nie działa w środowiskach zarządzanych, gdy użytkownik nie może odinstalować określonego rozszerzenia lub aplikacji. Jeśli odinstalowanie się nie powiedzie (np. użytkownik anuluje okno), obietnica zostanie odrzucona lub zostanie wywołane wywołanie zwrotne z ustawioną wartością runtime.lastError.

Parametry

Zwroty

  • thought Promise<void>

    Chrome 88 lub nowsza browser.* od Chrome 148

uninstallSelf()

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

Odinstalowuje rozszerzenie do połączeń. Uwaga: tej funkcji można używać bez prośby o uprawnienie „management” w pliku manifestu. Ta funkcja nie działa w środowiskach zarządzanych, gdy użytkownik nie może odinstalować określonego rozszerzenia lub aplikacji.

Parametry

Zwroty

  • thought Promise<void>

    Chrome 88 lub nowsza browser.* od Chrome 148

Wydarzenia

onDisabled

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

Uruchamiane, gdy aplikacja lub rozszerzenie zostaną wyłączone.

Parametry

onEnabled

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

Uruchamiane, gdy aplikacja lub rozszerzenie zostanie włączone.

Parametry

onInstalled

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

Uruchamiane po zainstalowaniu aplikacji lub rozszerzenia.

Parametry

onUninstalled

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

Uruchamiane, gdy aplikacja lub rozszerzenie zostaną odinstalowane.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (id: string) => void

    • id

      tekst