chrome.extension

Opis

Interfejs API chrome.extension zawiera narzędzia, których można używać na dowolnej stronie rozszerzenia. Obejmuje to obsługę wymiany wiadomości między rozszerzeniem a jego skryptami treści lub między rozszerzeniami, jak opisano szczegółowo w sekcji Przesyłanie wiadomości.

Typy

ViewType

Chrome 44 lub nowszy

Typ widoku rozszerzenia.

Typ wyliczeniowy

„tab”

„popup”

Właściwości

inIncognitoContext

Prawda w przypadku skryptów treści działających na kartach incognito oraz stron rozszerzeń działających w ramach procesu incognito. Ta ostatnia dotyczy tylko rozszerzeń z wartością „split” w parametrze incognito_behavior.

Typ

wartość logiczna

Metody

getBackgroundPage()

Tylko na pierwszym planie 
chrome.extension.getBackgroundPage()

Zwraca obiekt JavaScript „window” dla strony w tle działającej w bieżącym rozszerzeniu. Zwraca wartość null, jeśli rozszerzenie nie ma strony w tle.

Zwroty

  • Okno | nieokreślone

getViews()

Tylko na pierwszym planie 
chrome.extension.getViews(
  fetchProperties?: object,
)

Zwraca tablicę obiektów JavaScript „window” dla każdej strony działającej w bieżącym rozszerzeniu.

Parametry

  • fetchProperties

    object opcjonalne

    • tabId

      number opcjonalny

      Chrome 54 lub nowszy

      Znajdź widok według identyfikatora karty. Jeśli pominiesz to pole, zwróci wszystkie wyświetlenia.

    • typ

      ViewType opcjonalny

      Typ widoku. Jeśli pominiesz ten parametr, funkcja zwróci wszystkie widoki (w tym strony i karty w tle).

    • windowId

      number opcjonalny

      Okno, w którym ma być ograniczone wyszukiwanie. Jeśli pominiesz ten parametr, funkcja zwróci wszystkie widoki.

Zwroty

  • Window[]

    Tablica obiektów globalnych

isAllowedFileSchemeAccess()

Obietnice 
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

Pobiera stan dostępu rozszerzenia do schematu „plik://”. Odpowiada ono ustawieniu „Zezwalaj na dostęp do adresów URL plików” w przypadku poszczególnych rozszerzeń, które użytkownik może kontrolować na stronie chrome://extensions.

Parametry

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      wartość logiczna

      Wartość „prawda”, jeśli rozszerzenie może uzyskać dostęp do schematu „plik://”. W przeciwnym razie ma wartość „fałsz”.

Zwroty

  • Promise<boolean>

    Chrome 99+

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

isAllowedIncognitoAccess()

Obietnice 
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
)

Pobiera stan dostępu rozszerzenia do trybu incognito. Odpowiada ono ustawieniu „Dozwolone w trybie incognito” dla poszczególnych rozszerzeń, które użytkownik może kontrolować na stronie chrome://extensions.

Parametry

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      wartość logiczna

      Wartość „prawda”, jeśli rozszerzenie ma dostęp do trybu incognito. W przeciwnym razie ma wartość „fałsz”.

Zwroty

  • Promise<boolean>

    Chrome 99+

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

Ustawia wartość parametru ap CGI używanego w adresie URL aktualizacji rozszerzenia. Ta wartość jest ignorowana w przypadku rozszerzeń hostowanych w Galerii rozszerzeń do Chrome.

Parametry

  • dane

    ciąg znaków

Wydarzenia