chrome.management

Opis

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

Uprawnienia

management

Plik manifestu

Musisz zadeklarować zarządzanie. uprawnienia w pliku manifestu rozszerzenia na korzystanie z funkcji zarządzania API. Na przykład:

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

management.getPermissionWarningsByManifest, management.uninstallSelf i management.getSelf nie wymaga uprawnień do zarządzania.

Typy

ExtensionDisabledReason

Chrome w wersji 44 lub nowszej .

Powód wyłączenia elementu.

Typ wyliczeniowy

"nieznany"

"permissions_increase"

ExtensionInfo

Informacje o zainstalowanym rozszerzeniu, aplikacji lub motywie.

Właściwości

  • appLaunchUrl

    ciąg znaków opcjonalny

    URL uruchamiania (dostępny tylko w przypadku aplikacji).

  • availableLaunchTypes

    LaunchType[] opcjonalny

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

  • opis

    ciąg znaków

    Opis rozszerzenia, aplikacji lub motywu.

  • disabledReason

    ExtensionDisabledReason opcjonalny

    Powód wyłączenia elementu.

  • włączone

    wartość logiczna

    Wskazuje, czy funkcja jest obecnie włączona czy wyłączona.

  • homepageUrl

    ciąg znaków opcjonalny

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

  • hostPermissions

    ciąg znaków[]

    Zwraca listę uprawnień opartych na hoście.

  • ikony

    IconInfo[] opcjonalne

    Lista informacji o ikonach. Pamiętaj, że odzwierciedla to tylko to, co zadeklarowano w pliku manifestu, a rzeczywisty obraz pod tym adresem URL może być większy lub mniejszy od zadeklarowanego. Dlatego w tagach img odwołujących się do tych obrazów warto użyć wyraźnych atrybutów szerokości i wysokości. Więcej informacji znajdziesz w dokumentacji dotyczącej demonstracji dotyczącej ikon.

  • id

    ciąg znaków

    Unikalny identyfikator rozszerzenia.

  • installType

    ExtensionInstallType

    Sposób instalacji rozszerzenia.

  • isApp

    wartość logiczna

    Wycofano

    Użyj adresu management.ExtensionInfo.type.

    Prawda, jeśli to aplikacja.

  • launchType

    Opcjonalny LaunchType

    Typ uruchamiania aplikacji (dostępny tylko w przypadku aplikacji).

  • mayDisable

    wartość logiczna

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

  • mayEnable

    Wartość logiczna opcjonalna

    Chrome w wersji 62 lub nowszej .

    Określa, czy użytkownik może włączyć to rozszerzenie. Ten parametr jest zwracany tylko w przypadku wyłączonych rozszerzeń.

  • nazwa

    ciąg znaków

    Nazwa rozszerzenia, aplikacji lub motywu.

  • offlineEnabled

    wartość logiczna

    Określa, czy rozszerzenie, aplikacja lub motyw deklaruje, że obsługuje tryb offline.

  • optionsUrl

    ciąg znaków

    Adres URL strony opcji produktu (jeśli ją zawiera).

  • uprawnienia

    ciąg znaków[]

    Zwraca listę uprawnień opartych na interfejsie API.

  • skróconaNazwa

    ciąg znaków

    Krótka wersja nazwy rozszerzenia, aplikacji lub motywu.

  • Typ rozszerzenia, aplikacji lub motywu.

  • updateUrl

    ciąg znaków opcjonalny

    Adres URL aktualizacji rozszerzenia, aplikacji lub motywu.

  • wersja

    ciąg znaków

    Wersja rozszerzenia, aplikacji lub motywu.

  • versionName

    ciąg znaków opcjonalny

    Chrome w wersji 50 lub nowszej .

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

ExtensionInstallType

Chrome w wersji 44 lub nowszej .

Sposób instalacji rozszerzenia. Jedna z tych wartości: admin: rozszerzenie zostało zainstalowane ze względu na zasadę administracyjną, development: rozszerzenie zostało załadowane w trybie programisty w trybie programisty, normal: rozszerzenie zostało zainstalowane normalnie z pliku .crx, sideload: rozszerzenie zostało zainstalowane przez inne oprogramowanie na komputerze other: rozszerzenie zostało zainstalowane w inny sposób.

Typ wyliczeniowy

"admin"

"rozwój"

"normal"

"sideload"

"inna"

ExtensionType

Chrome w wersji 44 lub nowszej .

Typ rozszerzenia, aplikacji lub motywu.

Typ wyliczeniowy

"extension"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"login_screen_extension"

IconInfo

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

Właściwości

  • rozmiar

    liczba

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

  • URL

    ciąg znaków

    Adres URL obrazu ikony. Aby wyświetlić ikonę w skali szarości (np. że rozszerzenie jest wyłączone), do adresu URL dodaj ?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 i nowsze .

Opcje sposobu przeprowadzenia odinstalowywania rozszerzenia.

Właściwości

  • showConfirmDialog

    Wartość logiczna opcjonalna

    Określa, czy użytkownik ma zobaczyć okno potwierdzenia/odinstalowania. Wartość domyślna to fałsz w przypadku samodzielnych odinstalowań. Jeśli rozszerzenie odinstaluje inne rozszerzenie, ten parametr będzie ignorowany, a to okno będzie zawsze widoczne.

Metody

createAppShortcut()

Obietnica .
chrome.management.createAppShortcut(
  id: string,
  callback?: function,
)

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

Parametry

  • id

    ciąg znaków

    Powinien to być identyfikator z elementu aplikacji management.ExtensionInfo.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

Obietnica .
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
)

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

Parametry

  • URL

    ciąg znaków

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

  • tytuł

    ciąg znaków

    Tytuł wygenerowanej aplikacji.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: ExtensionInfo) => void

Zwroty

  • Promise&lt;ExtensionInfo&gt;

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

get()

Obietnica .
chrome.management.get(
  id: string,
  callback?: function,
)

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

Parametry

Zwroty

  • Promise&lt;ExtensionInfo&gt;

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getAll()

Obietnica .
chrome.management.getAll(
  callback?: function,
)

Zwraca listę informacji o zainstalowanych rozszerzeniach i aplikacjach.

Parametry

Zwroty

  • Promise&lt;ExtensionInfo[]&gt;

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getPermissionWarningsById()

Obietnica .
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
)

Zwraca listę ostrzeżeń o uprawnieniach dla podanego identyfikatora rozszerzenia.

Parametry

  • id

    ciąg znaków

    Identyfikator zainstalowanego już rozszerzenia.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (permissionWarnings: string[]) => void

    • permissionWarnings

      ciąg znaków[]

Zwroty

  • Promise&lt;string[]&gt;

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getPermissionWarningsByManifest()

Obietnica .
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
)

Zwraca listę ostrzeżeń o uprawnieniach dla danego ciągu znaków w pliku manifestu rozszerzenia. Uwaga: z tej funkcji można korzystać bez żądania „zarządzania” uprawnienia użytkownika w pliku manifestu.

Parametry

  • manifestStr

    ciąg znaków

    Ciąg znaków JSON manifestu rozszerzenia.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (permissionWarnings: string[]) => void

    • permissionWarnings

      ciąg znaków[]

Zwroty

  • Promise&lt;string[]&gt;

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getSelf()

Obietnica .
chrome.management.getSelf(
  callback?: function,
)

Zwraca informacje o rozszerzeniu do połączeń, aplikacji lub motywie. Uwaga: z tej funkcji można korzystać bez żądania „zarządzania” uprawnienia użytkownika w pliku manifestu.

Parametry

Zwroty

  • Promise&lt;ExtensionInfo&gt;

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

installReplacementWebApp()

Obietnica Chrome w wersji 77 lub nowszej 
chrome.management.installReplacementWebApp(
  callback?: function,
)

Uruchamia element zastępczy parametru zastępczym wymieniony w pliku manifestu. Wyświetla użytkownikowi prośbę o zainstalowanie, jeśli aplikacja nie jest jeszcze zainstalowana.

Parametry

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

launchApp()

Obietnica .
chrome.management.launchApp(
  id: string,
  callback?: function,
)

Uruchamia aplikację.

Parametry

  • id

    ciąg znaków

    Identyfikator rozszerzenia aplikacji.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

setEnabled()

Obietnica .
chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
)

Włącza lub wyłącza aplikację lub rozszerzenie. W większości przypadków ta funkcja musi być wywoływana w kontekście gestu użytkownika (np. moduł obsługi „onclick” dla przycisku) i może wyświetlać użytkownikowi natywny interfejs potwierdzenia jako sposób zapobiegania nadużyciom.

Parametry

  • id

    ciąg znaków

    Powinien to być identyfikator produktu management.ExtensionInfo.

  • włączone

    wartość logiczna

    Określa, czy ten element ma być włączony czy wyłączony.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

setLaunchType()

Obietnica .
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
)

Ustaw typ uruchamiania aplikacji.

Parametry

  • id

    ciąg znaków

    Powinien to być identyfikator z elementu aplikacji management.ExtensionInfo.

  • launchType

    LaunchType

    Docelowy typ uruchomienia. Zawsze sprawdzaj, czy ten typ uruchamiania to ExtensionInfo.availableLaunchTypes, ponieważ dostępne typy uruchamiania różnią się w zależności od platformy i konfiguracji.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

uninstall()

Obietnica .
chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
)

Odinstalowuje aktualnie 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 uda (np. użytkownik anuluje okno), obietnica zostanie odrzucona lub wywołanie zwrotne zostanie wysłane z ustawionym parametrem runtime.lastError.

Parametry

Zwroty

  • Obietnica<void>

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

uninstallSelf()

Obietnica .
chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
)

Odinstalowuje rozszerzenie do połączeń. Uwaga: z tej funkcji można korzystać bez żądania „zarządzania” uprawnienia użytkownika w pliku manifestu. Ta funkcja nie działa w środowiskach zarządzanych, gdy użytkownik nie może odinstalować określonego rozszerzenia/aplikacji.

Parametry

  • Opcje

    UninstallOptions opcje

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onDisabled

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

Uruchamiane po wyłączeniu aplikacji lub rozszerzenia.

Parametry

onEnabled

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

Uruchamiane po włączeniu aplikacji lub rozszerzenia.

Parametry

onInstalled

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

Uruchamiane po zainstalowaniu aplikacji lub rozszerzenia.

Parametry

onUninstalled

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

Uruchamiane po odinstalowaniu aplikacji lub rozszerzenia.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (id: string) => void

    • id

      ciąg znaków