chrome.extension

Opis

Interfejs chrome.extension API zawiera narzędzia, z których może korzystać każda strona rozszerzenia. Obejmuje to obsługę wymiany wiadomości między rozszerzeniem a jego skryptami dotyczącymi treści lub między rozszerzeniami, co zostało szczegółowo opisane w sekcji Przekazywanie wiadomości.

Typy

ViewType

Chrome 44 lub nowszy

Typ widoku rozszerzenia.

Typ wyliczeniowy

„tab”

"popup"

Właściwości

inIncognitoContext

Wartość „true” w przypadku skryptów dotyczących zawartości działających na kartach incognito i stron rozszerzeń działających w procesie incognito. Dotyczy to tylko rozszerzeń z ustawieniem incognito_behavior ustawionym na „split”.

Typ

Wartość logiczna

Metody

getBackgroundPage()

Tylko pierwszy plan 
chrome.extension.getBackgroundPage(): Window | undefined

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

Zwroty

  • Window | undefined

getViews()

Tylko pierwszy plan 
chrome.extension.getViews(
  fetchProperties?: object,
): Window[]

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

Parametry

  • fetchProperties

    obiekt opcjonalny

    • tabId

      number opcjonalny

      Chrome 54 lub nowsza

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

    • typ

      ViewType opcjonalny

      Typ widoku do pobrania. Jeśli ten parametr zostanie pominięty, funkcja zwróci wszystkie widoki (w tym strony i karty w tle).

    • windowId

      number opcjonalny

      Okres, w którym ma być prowadzone wyszukiwanie. Jeśli ten parametr zostanie pominięty, funkcja zwróci wszystkie widoki.

Zwroty

  • Window[]

    Tablica obiektów globalnych

isAllowedFileSchemeAccess()

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

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

Zwroty

  • Promise<boolean>

    Chrome 99 lub nowsza

isAllowedIncognitoAccess()

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

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

Zwroty

  • Promise<boolean>

    Chrome 99 lub nowsza

setUpdateUrlData()

chrome.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ń Chrome.

Parametry

  • dane

    ciąg znaków

Wydarzenia