browser.extension

Opis

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

Typy

ViewType

Chrome 44 lub nowsza browser.* od Chrome 148

Typ widoku rozszerzenia.

Typ wyliczeniowy

"tab"

"popup"

Właściwości

inIncognitoContext

Wartość „true” w przypadku skryptów treści uruchamianych na kartach incognito i stron rozszerzeń uruchamianych w procesie incognito. Ta druga opcja dotyczy tylko rozszerzeń z ustawieniem „split” w polu incognito_behavior.

Typ

wartość logiczna

Metody

getBackgroundPage()

Tylko na pierwszym planie

browser.extension.getBackgroundPage(): Window | undefined

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

Zwroty

• Okno | niezdefiniowane

getViews()

Tylko na pierwszym planie

browser.extension.getViews(
  fetchProperties?: object,
): Window[]

Zwraca tablicę obiektów „window” JavaScriptu dla każdej strony działającej w ramach bieżącego rozszerzenia.

Parametry

• fetchProperties

  object opcjonalny

  • tabId

    number optional

    Chrome 54 lub nowsza browser.* od Chrome 148

    Znajdź widok według identyfikatora karty. Jeśli pominiesz to pole, zostaną zwrócone wszystkie widoki.

  • typ

    ViewType opcjonalny

    Typ widoku, który chcesz uzyskać. Jeśli zostanie pominięty, zwracane są wszystkie widoki (w tym strony i karty w tle).

  • windowId

    number optional

    Okno, do którego ma zostać ograniczone wyszukiwanie. Jeśli go pominiesz, zostaną zwrócone wszystkie widoki.

Zwroty

• Okno[]

  Tablica obiektów globalnych

isAllowedFileSchemeAccess()

browser.extension.isAllowedFileSchemeAccess(): Promise<boolean>

Pobiera stan dostępu rozszerzenia do schematu „file://”. Odpowiada to kontrolowanemu przez użytkownika ustawieniu „Zezwalaj na dostęp do adresów URL plików” dla poszczególnych rozszerzeń, które jest dostępne na stronie chrome://extensions.

Zwroty

• Promise<boolean>

  Chrome 99 lub nowsza wersja browser.* od Chrome 148

isAllowedIncognitoAccess()

browser.extension.isAllowedIncognitoAccess(): Promise<boolean>

Pobiera stan dostępu rozszerzenia do trybu incognito. Odpowiada to kontrolowanemu przez użytkownika ustawieniu „Zezwalaj w trybie incognito” dla poszczególnych rozszerzeń, które jest dostępne na stronie chrome://extensions.

Zwroty

• Promise<boolean>

  Chrome 99 lub nowsza wersja browser.* od Chrome 148

setUpdateUrlData()

browser.extension.setUpdateUrlData(
  data: string,
): void

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

Parametry

• dane

  tekst