Dokumentacja API

refresh date: 2026-09-25 robots: noindex

Większość rozszerzeń do Chrome potrzebuje dostępu do co najmniej jednego interfejsu API rozszerzeń do Chrome, aby działać. Ten dokumentacja API opisuje interfejsy API, których można używać w rozszerzeniach, i zawiera przykłady przypadków użycia.

accessibilityFeatures

Użyj interfejsu chrome.accessibilityFeatures API, aby zarządzać ułatwieniami dostępu w Chrome. Ten interfejs API korzysta z prototypu ChromeSetting interfejsu API typu do pobierania i ustawiania poszczególnych funkcji ułatwień dostępu. Aby uzyskać stany funkcji, rozszerzenie musi poprosić o uprawnienie accessibilityFeatures.read. Aby modyfikować stan funkcji, rozszerzenie potrzebuje uprawnienia accessibilityFeatures.modify. Pamiętaj, że accessibilityFeatures.modify nie oznacza uprawnienia accessibilityFeatures.read.

alarms

Użyj interfejsu chrome.alarms API, aby zaplanować okresowe uruchamianie kodu lub uruchamianie go w określonym czasie w przyszłości.

audio
Chrome 59 lub nowszy Tylko ChromeOS

Interfejs chrome.audio API umożliwia użytkownikom uzyskiwanie informacji o urządzeniach audio podłączonych do systemu i sterowanie nimi. Ten interfejs API jest obecnie dostępny tylko w trybie kiosku w ChromeOS.

zakładki

Użyj interfejsu chrome.bookmarks API, aby tworzyć, porządkować i w inny sposób zarządzać zakładkami. Zobacz też Zastępowanie stron, które umożliwia utworzenie niestandardowej strony Menedżera zakładek.

browserAction
≤ MV2

Za pomocą działań przeglądarki możesz umieszczać ikony na głównym pasku narzędzi Google Chrome, po prawej stronie paska adresu. Oprócz ikony działanie przeglądarki może mieć etykietkę, plakietkę i wyskakujące okienko.

browsingData

Użyj interfejsu chrome.browsingData API, aby usunąć dane przeglądania z lokalnego profilu użytkownika.

certificateProvider
Chrome 46 lub nowszy Tylko ChromeOS

Użyj tego interfejsu API, aby udostępnić certyfikaty platformie, która może ich używać do uwierzytelniania TLS.

polecenia

Użyj interfejsu Commands API, aby dodać skróty klawiszowe, które wywołują działania w rozszerzeniu, np. otwierają działanie przeglądarki lub wysyłają polecenie do rozszerzenia.

contentSettings

Użyj interfejsu chrome.contentSettings API, aby zmienić ustawienia określające, czy witryny mogą korzystać z takich funkcji, jak pliki cookie, JavaScript i wtyczki. Ustawienia treści umożliwiają dostosowywanie działania Chrome w przypadku poszczególnych witryn, a nie globalnie.

contextMenus

Użyj interfejsu chrome.contextMenus API, aby dodać elementy do menu kontekstowego Google Chrome. Możesz wybrać, do jakich typów obiektów mają się odnosić dodatki do menu kontekstowego, np. do obrazów, hiperlinków i stron.

pliki cookie

Używaj interfejsu chrome.cookies API do wysyłania zapytań dotyczących plików cookie i ich modyfikowania oraz do otrzymywania powiadomień o ich zmianach.

debuger

Interfejs chrome.debugger API służy jako alternatywny transport dla protokołu zdalnego debugowania w Chrome. Użyj chrome.debugger, aby dołączyć do co najmniej 1 karty i instrumentować interakcje sieciowe, debugować JavaScript, zmieniać DOM i CSS oraz wykonywać inne czynności. Użyj właściwości Debuggee tabId, aby kierować zdarzenia do kart z wartością sendCommand i kierować zdarzenia według wartości tabId z wywołań zwrotnych onEvent.

declarativeContent

Używaj interfejsu chrome.declarativeContent API do wykonywania działań w zależności od treści strony bez konieczności uzyskiwania uprawnień do odczytywania treści strony.

declarativeNetRequest
Chrome 84 lub nowsza

Interfejs chrome.declarativeNetRequest API służy do blokowania lub modyfikowania żądań sieciowych przez określanie reguł deklaratywnych. Dzięki temu rozszerzenia mogą modyfikować żądania sieciowe bez ich przechwytywania i wyświetlania ich zawartości, co zapewnia większą prywatność.

declarativeWebRequest
Wersja beta ≤ MV2

Uwaga: ten interfejs API został wycofany. Zamiast tego użyj interfejsu declarativeNetRequest API. Użyj interfejsu chrome.declarativeWebRequest API, aby przechwytywać, blokować lub modyfikować żądania w trakcie ich przesyłania. Jest on znacznie szybszy niż interfejs API chrome.webRequest, ponieważ możesz rejestrować reguły, które są oceniane w przeglądarce, a nie w mechanizmie JavaScript. Zmniejsza to opóźnienia związane z ruchem w obie strony i zwiększa wydajność.

desktopCapture

Interfejs Desktop Capture API przechwytuje zawartość ekranu, poszczególnych okien lub poszczególnych kart.

devtools.inspectedWindow

Użyj interfejsu chrome.devtools.inspectedWindow API, aby wchodzić w interakcje ze sprawdzanym oknem: uzyskać identyfikator karty sprawdzanej strony, ocenić kod w kontekście sprawdzanego okna, ponownie załadować stronę lub uzyskać listę zasobów na stronie.

devtools.network

Użyj interfejsu chrome.devtools.network API, aby pobrać informacje o żądaniach sieciowych wyświetlane przez Narzędzia dla programistów w panelu Sieć.

devtools.panels

Użyj interfejsu chrome.devtools.panels API, aby zintegrować rozszerzenie z interfejsem okna Narzędzi deweloperskich: twórz własne panele, uzyskuj dostęp do istniejących paneli i dodawaj paski boczne.

devtools.performance
Chrome 129 lub nowsza

Użyj interfejsu chrome.devtools.performance API, aby nasłuchiwać aktualizacji stanu nagrywania w panelu Wydajność w Narzędziach deweloperskich.

devtools.recorder
Chrome 105 lub nowsza

Użyj interfejsu chrome.devtools.recorder API, aby dostosować panel Rejestrator w Narzędziach deweloperskich.

dns
Wersja deweloperska

Użyj interfejsu chrome.dns API do rozpoznawania DNS.

documentScan
Chrome 44 lub nowszy Tylko ChromeOS

Użyj interfejsu chrome.documentScan API, aby wykrywać i pobierać obrazy z podłączonych skanerów dokumentów.

dom
Chrome 88 lub nowsza

Użyj interfejsu chrome.dom API, aby uzyskać dostęp do specjalnych interfejsów DOM API dla rozszerzeń.

pobrane

Użyj interfejsu chrome.downloads API, aby automatycznie inicjować, monitorować, modyfikować i wyszukiwać pobierane pliki.

enterprise.deviceAttributes
Chrome 46 lub nowszy Tylko ChromeOS Wymaga zasady

Użyj interfejsu chrome.enterprise.deviceAttributes API, aby odczytać atrybuty urządzenia. Uwaga: ten interfejs API jest dostępny tylko dla rozszerzeń, których instalacja została wymuszona na podstawie zasad firmy.

enterprise.hardwarePlatform
Chrome 71 lub nowszy Wymaga zasad

Użyj interfejsu chrome.enterprise.hardwarePlatform API, aby uzyskać informacje o producencie i modelu platformy sprzętowej, na której działa przeglądarka. Uwaga: ten interfejs API jest dostępny tylko dla rozszerzeń zainstalowanych przez zasady firmy.

enterprise.login
Chrome 139 lub nowszy Tylko ChromeOS Wymaga zasad

Użyj interfejsu chrome.enterprise.login API, aby zakończyć zarządzane sesje gościa. Uwaga: ten interfejs API jest dostępny tylko dla rozszerzeń zainstalowanych przez zasady firmy w zarządzanych sesjach gościa w ChromeOS.

enterprise.networkingAttributes
Chrome 85 lub nowszy Tylko ChromeOS Wymaga zasad

Użyj interfejsu chrome.enterprise.networkingAttributes API, aby odczytać informacje o bieżącej sieci. Uwaga: ten interfejs API jest dostępny tylko dla rozszerzeń, których instalacja została wymuszona na podstawie zasad firmy.

enterprise.platformKeys
Tylko ChromeOS Wymaga zasad

Użyj interfejsu chrome.enterprise.platformKeys API, aby wygenerować klucze i zainstalować certyfikaty dla tych kluczy. Certyfikaty będą zarządzane przez platformę i mogą być używane do uwierzytelniania TLS, dostępu do sieci lub przez inne rozszerzenia za pomocą interfejsu chrome.platformKeys.

zdarzenia

Przestrzeń nazw chrome.events zawiera typowe typy używane przez interfejsy API wysyłające zdarzenia, aby powiadamiać Cię o interesujących zdarzeniach.

extension

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.

extensionTypes

Interfejs chrome.extensionTypes API zawiera deklaracje typów rozszerzeń do Chrome.

fileBrowserHandler
Tylko ChromeOS Tylko na pierwszym planie

Użyj interfejsu chrome.fileBrowserHandler API, aby rozszerzyć przeglądarkę plików w ChromeOS. Możesz na przykład użyć tego interfejsu API, aby umożliwić użytkownikom przesyłanie plików do Twojej witryny.

fileSystemProvider
Tylko ChromeOS

Użyj interfejsu chrome.fileSystemProvider API, aby tworzyć systemy plików, które będą dostępne w menedżerze plików w ChromeOS.

fontSettings

Użyj interfejsu chrome.fontSettings API, aby zarządzać ustawieniami czcionek w Chrome.

gcm

Użyj chrome.gcm, aby umożliwić aplikacjom i rozszerzeniom wysyłanie i odbieranie wiadomości za pomocą Komunikacji w chmurze Firebase (FCM).

historia

Użyj interfejsu chrome.history API, aby korzystać z historii odwiedzonych stron w przeglądarce. Możesz dodawać i usuwać adresy URL w historii przeglądarki oraz wyszukiwać je. Aby zastąpić stronę historii własną wersją, zapoznaj się z sekcją Zastępowanie stron.

i18n

Użyj infrastruktury chrome.i18n, aby wdrożyć internacjonalizację w całej aplikacji lub rozszerzeniu.

identity

Użyj interfejsu chrome.identity API, aby uzyskać tokeny dostępu OAuth2.

idle

Użyj interfejsu chrome.idle API, aby wykrywać zmiany stanu bezczynności urządzenia.

input.ime
Tylko ChromeOS

Użyj interfejsu chrome.input.ime API, aby wdrożyć niestandardowy edytor IME w ChromeOS. Dzięki temu rozszerzenie może obsługiwać naciśnięcia klawiszy, ustawiać kompozycję i zarządzać oknem propozycji.

instanceID
Chrome 44 lub nowsza

Aby uzyskać dostęp do usługi identyfikatora instancji, użyj nazwy chrome.instanceID.

loginState
Chrome w wersji 78 lub nowszej Tylko ChromeOS

Użyj interfejsu chrome.loginState API, aby odczytywać stan logowania i go monitorować.

filmami

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

mimeHandler
Chrome 151 lub nowsza

Użyj interfejsu chrome.mimeHandler API do obsługi strumieni typów MIME w rozszerzeniach innych firm.

notifications

Użyj interfejsu chrome.notifications API, aby tworzyć rozbudowane powiadomienia za pomocą szablonów i wyświetlać je użytkownikom w obszarze powiadomień.

omnibox

Interfejs API omniboksu umożliwia zarejestrowanie słowa kluczowego na pasku adresu Google Chrome, który jest też nazywany omniboksem.

pageAction
≤ MV2

Użyj interfejsu chrome.pageAction API, aby umieścić ikony na głównym pasku narzędzi Google Chrome po prawej stronie paska adresu. Działania na stronie to działania, które można wykonać na bieżącej stronie, ale nie mają zastosowania do wszystkich stron. Działania na stronie są wyszarzone, gdy są nieaktywne.

pageCapture

Zapisz kartę jako MHTML za pomocą interfejsu API chrome.pageCapture.

uprawnienia,

Używaj interfejsu chrome.permissions API, aby prosić o zadeklarowane uprawnienia opcjonalne w czasie działania aplikacji, a nie podczas instalacji. Dzięki temu użytkownicy będą rozumieć, do czego potrzebne są konkretne uprawnienia, i przyznawać tylko te, które są niezbędne.

platformKeys
Chrome 45 lub nowszy Tylko ChromeOS

Użyj interfejsu chrome.platformKeys API, aby uzyskać dostęp do certyfikatów klienta zarządzanych przez platformę. Jeśli użytkownik lub zasady przyznają uprawnienia, rozszerzenie może używać takiego certyfikatu w swoim niestandardowym protokole uwierzytelniania. Umożliwia to na przykład korzystanie z certyfikatów zarządzanych przez platformę w usługach VPN innych firm (patrz chrome.vpnProvider).

power

Użyj interfejsu chrome.power API, aby zastąpić funkcje zarządzania energią systemu.

printerProvider
Chrome 44 lub nowsza

Interfejs chrome.printerProvider API udostępnia zdarzenia używane przez menedżera drukowania do wysyłania zapytań o drukarki kontrolowane przez rozszerzenia, ich możliwości i przesyłania do nich zadań drukowania.

drukowanie
Chrome 81 lub nowszy Tylko ChromeOS

Użyj interfejsu chrome.printing API, aby wysyłać zadania drukowania do drukarek zainstalowanych na Chromebooku.

printingMetrics
Chrome 79 lub nowszy Tylko ChromeOS Wymaga zasad

Użyj interfejsu chrome.printingMetrics API, aby pobrać dane o korzystaniu z drukowania.

prywatność

Użyj interfejsu chrome.privacy API, aby kontrolować korzystanie z funkcji Chrome, które mogą wpływać na prywatność użytkownika. Ten interfejs API korzysta z prototypu ChromeSetting interfejsu API typu do pobierania i ustawiania konfiguracji Chrome.

procesy,
Wersja deweloperska

Użyj interfejsu chrome.processes API, aby wchodzić w interakcje z procesami przeglądarki.

proxy

Użyj interfejsu chrome.proxy API, aby zarządzać ustawieniami serwera proxy Chrome. Ten interfejs API korzysta z prototypu ChromeSetting typu API do pobierania i ustawiania konfiguracji serwera proxy.

publicSuffix
Chrome 153 lub nowsza

Użyj interfejsu API chrome.publicSuffix, aby wysłać zapytanie do listy sufiksów publicznych (PSL) przeglądarki.

runtime

Użyj interfejsu API chrome.runtime, aby pobrać skrypt service worker, zwrócić szczegóły pliku manifestu oraz nasłuchiwać zdarzeń w cyklu życia rozszerzenia i na nie odpowiadać. Za pomocą tego interfejsu API możesz też przekształcać ścieżki względne adresów URL w pełne adresy URL.

search
Chrome 87 lub nowsza

Użyj interfejsu chrome.search API, aby wyszukiwać za pomocą domyślnego dostawcy.

sesje

Użyj interfejsu chrome.sessions API, aby wysyłać zapytania o karty i okna z sesji przeglądania oraz je przywracać.

miejsce na dane

Używaj interfejsu chrome.storage API do przechowywania, pobierania i śledzenia zmian w danych użytkowników.

system.cpu

Użyj interfejsu system.cpu API, aby wysyłać zapytania o metadane procesora.

system.display

Użyj interfejsu system.display API, aby wysyłać zapytania o wyświetlane metadane.

system.memory

Interfejs API chrome.system.memory.

system.storage

Użyj interfejsu chrome.system.storage API, aby wysyłać zapytania o informacje o urządzeniu pamięci masowej i otrzymywać powiadomienia o podłączeniu i odłączeniu wymiennego urządzenia pamięci masowej.

systemLog
Chrome w wersji 125 lub nowszej Tylko ChromeOS Wymaga zasad

Użyj interfejsu chrome.systemLog API, aby rejestrować logi systemowe Chrome z rozszerzeń.

tabCapture

Użyj interfejsu chrome.tabCapture API, aby korzystać ze strumieni multimediów z kart.

karty,

Użyj interfejsu chrome.tabs API, aby korzystać z systemu kart przeglądarki. Za pomocą tego interfejsu API możesz tworzyć, modyfikować i przenosić karty w przeglądarce.

topSites

Użyj interfejsu chrome.topSites API, aby uzyskać dostęp do najpopularniejszych witryn (czyli najczęściej odwiedzanych), które są wyświetlane na stronie nowej karty. Nie obejmują one skrótów dostosowanych przez użytkownika.

tts

Użyj interfejsu chrome.tts API, aby odtwarzać zsyntetyzowany tekst zamieniony na mowę (TTS). Zobacz też powiązany interfejs ttsEngine API, który umożliwia rozszerzeniu wdrożenie silnika mowy.

ttsEngine

Użyj interfejsu chrome.ttsEngine API, aby wdrożyć silnik zamiany tekstu na mowę(TTS) za pomocą rozszerzenia. Jeśli rozszerzenie zarejestruje się za pomocą tego interfejsu API, będzie otrzymywać zdarzenia zawierające wypowiedź do odczytania i inne parametry, gdy dowolne rozszerzenie lub aplikacja Chrome użyje interfejsu tts API do generowania mowy. Rozszerzenie może następnie użyć dowolnej dostępnej technologii internetowej do syntezy i wygenerowania mowy oraz wysłać zdarzenia z powrotem do funkcji wywołującej, aby zgłosić stan.

types

Interfejs chrome.types API zawiera deklaracje typów dla Chrome.

vpnProvider
Chrome 43 lub nowszy Tylko ChromeOS

Użyj interfejsu chrome.vpnProvider API, aby wdrożyć klienta VPN.

tapeta
Chrome 43 lub nowszy Tylko ChromeOS

Użyj interfejsu chrome.wallpaper API, aby zmienić tapetę w ChromeOS.

webNavigation

Używaj interfejsu chrome.webNavigation API, aby otrzymywać powiadomienia o stanie żądań nawigacji w trakcie realizacji.

webRequest

Użyj interfejsu chrome.webRequest API, aby obserwować i analizować ruch oraz przechwytywać, blokować lub modyfikować żądania w trakcie przesyłania.

windows

Używaj interfejsu chrome.windows API do interakcji z oknami przeglądarki. Za pomocą tego interfejsu API możesz tworzyć, modyfikować i przenosić okna w przeglądarce.