chrome.extension

refresh date: 2026-09-25 robots: noindex

Opis

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

Typy

ViewType

Chrome 44 lub nowsza

Typ widoku rozszerzenia.

Typ wyliczeniowy

„tab”

„popup”

Właściwości

inIncognitoContext

Wartość „true” w przypadku skryptów treś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

lastError

≤ MV2 Wycofane w Chrome 58

Użyj runtime.lastError.

Ustawiana na czas trwania wywołania zwrotnego, jeśli asynchroniczny interfejs API rozszerzenia spowodował błąd. Jeśli nie wystąpił żaden błąd, lastError będzie mieć wartość undefined.

Typ

obiekt

Właściwości

  • wiadomość

    tekst

    Opis błędu, który wystąpił.

Metody

getBackgroundPage()

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

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

Zwroty

  • Window | undefined

getExtensionTabs()

≤ MV2 Tylko pierwszy plan Wycofano
chrome.extension.getExtensionTabs(
  windowId?: number,
): Window[]

Użyj extension.getViews {type: "tab"}.

Zwraca tablicę obiektów JavaScript „window” dla każdej karty działającej w bieżącym rozszerzeniu. Jeśli podano windowId, zwraca tylko obiekty „window” kart dołączonych do określonego okna.

Parametry

  • windowId

    number opcjonalny

Zwroty

  • Window[]

    Tablica obiektów okna globalnego

getURL()

≤ MV2 Wycofane w Chrome 58
chrome.extension.getURL(
  path: string,
): string

Użyj runtime.getURL.

Konwertuje ścieżkę względną w katalogu instalacyjnym rozszerzenia na pełny adres URL.

Parametry

  • ścieżka

    tekst

    Ścieżka do zasobu w rozszerzeniu wyrażona względem katalogu instalacyjnego.

Zwroty

  • tekst

    Pełny adres URL zasobu.

getViews()

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

Zwraca tablicę obiektów JavaScript „window” 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

      Określ okno, w którym ma się odbywać wyszukiwanie. Jeśli ten parametr zostanie pominięty, funkcja zwróci wszystkie widoki.

Zwroty

  • Window[]

    Tablica obiektów globalnych

isAllowedFileSchemeAccess()

Obietnica 
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
): 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 dla każdego rozszerzenia, które jest dostępne na stronie chrome://extensions.

Parametry

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      wartość logiczna

      Wartość true, jeśli rozszerzenie ma dostęp do schematu „file://”, w przeciwnym razie wartość false.

Zwroty

  • Promise<boolean>

    Chrome 99 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

isAllowedIncognitoAccess()

Obietnica 
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
): Promise<boolean>

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

Parametry

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      wartość logiczna

      Wartość true, jeśli rozszerzenie ma dostęp do trybu incognito, w przeciwnym razie wartość false.

Zwroty

  • Promise<boolean>

    Chrome 99 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

sendRequest()

Promise &leq; MV2 Wycofano
chrome.extension.sendRequest(
  extensionId?: string,
  request: any,
  callback?: function,
): Promise<any>

Użyj runtime.sendMessage.

Wysyła pojedynczą prośbę do innych odbiorców w ramach rozszerzenia. Podobne do runtime.connect, ale wysyła tylko jedno żądanie z opcjonalną odpowiedzią. Zdarzenie extension.onRequest jest wywoływane na każdej stronie rozszerzenia.

Parametry

  • extensionId

    ciąg znaków opcjonalny

    Identyfikator rozszerzenia, z którym chcesz utworzyć połączenie. Jeśli zostanie pominięty, domyślnie używane jest Twoje rozszerzenie.

  • żądanie

    każdy

  • callback

    funkcja opcjonalna

    Chrome 99 lub nowsza

    Parametr callback wygląda tak:

    (response: any) => void

    • odpowiedź

      każdy

      Obiekt odpowiedzi JSON wysłany przez moduł obsługi żądania. Jeśli podczas łączenia z rozszerzeniem wystąpi błąd, obietnica zostanie odrzucona.

Zwroty

  • Promise<any>

    Chrome 99 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

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

Parametry

  • dane

    tekst

Wydarzenia

onRequest

&leq; MV2 Wycofane
chrome.extension.onRequest.addListener(
  callback: function,
)

Użyj runtime.onMessage.

Wydarzenie wywoływane, gdy żądanie jest wysyłane z procesu rozszerzenia lub skryptu treści.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (request: any, sender: runtime.MessageSender, sendResponse: function) => void

    • żądanie

      każdy

    • sendResponse

      funkcja

      Parametr sendResponse wygląda tak:

      () => void

onRequestExternal

&leq; MV2 Wycofane
chrome.extension.onRequestExternal.addListener(
  callback: function,
)

Użyj runtime.onMessageExternal.

Wywoływane, gdy prośba jest wysyłana z innego rozszerzenia.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (request: any, sender: runtime.MessageSender, sendResponse: function) => void

    • żądanie

      każdy

    • sendResponse

      funkcja

      Parametr sendResponse wygląda tak:

      () => void