Większość rozszerzeń do Chrome potrzebuje dostępu do co najmniej jednego interfejsu API rozszerzeń do Chrome, aby działać. Ten dokument referencyjny interfejsów API opisuje interfejsy API dostępne do użycia w rozszerzeniach i przedstawia przykładowe przypadki użycia.
- accessibilityFeatures
-
Użyj interfejsu
chrome.accessibilityFeaturesAPI, aby zarządzać funkcjami ułatwień 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 uprawnienieaccessibilityFeatures.read. Aby modyfikować stan funkcji, rozszerzenie potrzebuje uprawnieniaaccessibilityFeatures.modify. Pamiętaj, że uprawnienieaccessibilityFeatures.modifynie oznacza uprawnieniaaccessibilityFeatures.read. - alarms
-
Użyj interfejsu
chrome.alarmsAPI, aby zaplanować uruchamianie kodu okresowo lub w określonym czasie w przyszłości. - audio
-
Chrome 59 lub nowszy Tylko ChromeOS
Interfejs
chrome.audioAPI 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.bookmarksAPI, aby tworzyć, porządkować i w inny sposób manipulować zakładkami. Zobacz też strony zastępowania, których możesz użyć do utworzenia niestandardowej strony menedżera zakładek. - browserAction
-
Działania przeglądarki umożliwiają umieszczanie ikon na głównym pasku narzędzi Google Chrome, po prawej stronie paska adresu. Oprócz ikony czynność wykonywana w przeglądarce może mieć etykietkę, plakietkę i wyskakujące okienko.
- browsingData
-
użyć interfejsu
chrome.browsingDataAPI, 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ć platformie certyfikaty, które mogą być używane do uwierzytelniania TLS.
- polecenia
-
Użyj interfejsu Commands API, aby dodać skróty klawiszowe, które wywołują działania w rozszerzeniu, np. otwieranie działania przeglądarki lub wysyłanie polecenia do rozszerzenia.
- contentSettings
-
Użyj interfejsu
chrome.contentSettingsAPI, aby zmienić ustawienia kontrolują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.contextMenusAPI, aby dodać elementy do menu kontekstowego Google Chrome. Możesz wybrać typy obiektów, do których mają być stosowane dodatki do menu kontekstowego, np. obrazy, hiperlinki i strony. - pliki cookie
-
Używaj interfejsu
chrome.cookiesAPI do wysyłania zapytań dotyczących plików cookie i ich modyfikowania oraz do otrzymywania powiadomień o ich zmianach. - debuger
-
Interfejs
chrome.debuggerAPI służy jako alternatywny transport dla protokołu zdalnego debugowania Chrome. Użyjchrome.debugger, aby dołączyć do co najmniej 1 karty i instrumentować interakcje sieciowe, debugować JavaScript, modyfikować DOM i CSS oraz wykonywać inne czynności. Użyj właściwościDebuggeetabId, aby kierować zdarzenia na karty z właściwościąsendCommandi kierować zdarzenia według właściwościtabIdz wywołań zwrotnychonEvent. - declarativeContent
-
Używaj interfejsu
chrome.declarativeContentAPI 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.declarativeNetRequestAPI 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
-
Kanał beta ≤ MV2
Uwaga: ten interfejs API został wycofany. Zamiast tego skorzystaj z interfejsu API
declarativeNetRequest. Użyj interfejsuchrome.declarativeWebRequestAPI, aby przechwytywać, blokować lub modyfikować żądania w trakcie ich przesyłania. Jest on znacznie szybszy niż interfejs APIchrome.webRequest, ponieważ możesz rejestrować reguły, które są oceniane w przeglądarce, a nie w silniku JavaScript. Zmniejsza to opóźnienia związane z wielokrotnym przesyłaniem danych 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.inspectedWindowAPI, aby wchodzić w interakcje z kontrolowanym oknem: uzyskać identyfikator karty kontrolowanej strony, ocenić kod w kontekście kontrolowanego okna, ponownie załadować stronę lub uzyskać listę zasobów na stronie. - devtools.network
-
Użyj interfejsu
chrome.devtools.networkAPI, aby pobrać informacje o żądaniach sieciowych wyświetlane przez Narzędzia dla programistów w panelu Sieć. - devtools.panels
-
Użyj interfejsu
chrome.devtools.panelsAPI, 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.performanceAPI, aby nasłuchiwać aktualizacji stanu nagrywania w panelu Wydajność w Narzędziach deweloperskich. - devtools.recorder
-
Chrome 105 lub nowsza
Użyj interfejsu
chrome.devtools.recorderAPI, aby dostosować panel Rejestrator w Narzędziach deweloperskich. - dns
-
Wersja deweloperska
Użyj interfejsu
chrome.dnsAPI do rozpoznawania DNS. - documentScan
-
Chrome 44 i nowsze Tylko ChromeOS
Użyj interfejsu
chrome.documentScanAPI, aby wykrywać i pobierać obrazy z podłączonych skanerów dokumentów. - dom
-
Chrome 88 lub nowsza
Użyj interfejsu
chrome.domAPI, aby uzyskać dostęp do specjalnych interfejsów DOM API dla rozszerzeń. - downloads
-
Za pomocą interfejsu
chrome.downloadsAPI możesz automatycznie inicjować, monitorować, modyfikować i wyszukiwać pobierane pliki. - enterprise.deviceAttributes
-
Użyj interfejsu
chrome.enterprise.deviceAttributesAPI, aby odczytać atrybuty urządzenia. Uwaga: ten interfejs API jest dostępny tylko dla rozszerzeń, których instalacja została wymuszona na podstawie zasad przedsiębiorstwa. - enterprise.hardwarePlatform
-
Chrome 71 i nowsze wersje Wymaga zasad
Użyj interfejsu
chrome.enterprise.hardwarePlatformAPI, 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 przedsiębiorstwa. - enterprise.login
-
Użyj interfejsu
chrome.enterprise.loginAPI, 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
-
Użyj interfejsu
chrome.enterprise.networkingAttributesAPI, 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 przedsiębiorstwa. - enterprise.platformKeys
-
Tylko ChromeOS Wymaga zasad
Użyj interfejsu
chrome.enterprise.platformKeysAPI, 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.eventszawiera typowe typy używane przez interfejsy API wysyłające zdarzenia, aby powiadamiać Cię o interesujących zdarzeniach. - extension
-
Interfejs
chrome.extensionAPI 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. - extensionTypes
-
Interfejs
chrome.extensionTypesAPI zawiera deklaracje typów dla rozszerzeń Chrome. - fileBrowserHandler
-
Tylko ChromeOS Tylko na pierwszym planie
Użyj interfejsu
chrome.fileBrowserHandlerAPI, 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 na Twoją stronę. - fileSystemProvider
-
Tylko ChromeOS
Użyj interfejsu
chrome.fileSystemProviderAPI, aby utworzyć systemy plików, które będą dostępne w menedżerze plików w ChromeOS. - fontSettings
-
Użyj interfejsu
chrome.fontSettingsAPI, 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.historyAPI, 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.identityAPI, aby uzyskać tokeny dostępu OAuth2. - idle
-
Użyj interfejsu
chrome.idleAPI, aby wykrywać zmiany stanu bezczynności urządzenia. - input.ime
-
Tylko ChromeOS
Użyj interfejsu
chrome.input.imeAPI, aby wdrożyć niestandardowy edytor IME dla ChromeOS. Dzięki temu rozszerzenie może obsługiwać naciśnięcia klawiszy, ustawiać kompozycję i zarządzać oknem sugestii. - instanceID
-
Chrome 44 lub nowszy
Aby uzyskać dostęp do usługi identyfikatora instancji, użyj nazwy
chrome.instanceID. - loginState
-
Chrome 78 lub nowszy Tylko ChromeOS
Użyj interfejsu
chrome.loginStateAPI, aby odczytywać i monitorować stan logowania. - filmami
-
Interfejs
chrome.managementAPI umożliwia zarządzanie zainstalowanymi aplikacjami i rozszerzeniami. - powiadomienia
-
Za pomocą interfejsu
chrome.notificationsAPI możesz tworzyć rozbudowane powiadomienia przy użyciu szablonów i wyświetlać je użytkownikom w zasobniku systemowym. - omnibox
-
Interfejs API omniboksu umożliwia zarejestrowanie słowa kluczowego na pasku adresu Google Chrome, który jest też nazywany omniboksem.
- pageAction
-
Użyj interfejsu
chrome.pageActionAPI, aby umieścić ikony na głównym pasku narzędzi Google Chrome, po prawej stronie paska adresu. Działania dotyczące strony to czynności, 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
-
Użyj interfejsu
chrome.pageCaptureAPI, aby zapisać kartę w formacie MHTML. - uprawnienia,
-
Używaj interfejsu
chrome.permissionsAPI, aby prosić o zadeklarowane uprawnienia opcjonalne w czasie działania aplikacji, a nie w czasie instalacji. Dzięki temu użytkownicy będą rozumieć, dlaczego aplikacja potrzebuje tych uprawnień, i przyznawać tylko te, które są niezbędne. - platformKeys
-
Chrome 45 lub nowszy Tylko ChromeOS
Użyj interfejsu API
chrome.platformKeys, 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 np. korzystanie z certyfikatów zarządzanych przez platformę w usługach VPN innych firm (patrz chrome.vpnProvider). - power
-
Użyj interfejsu
chrome.powerAPI, aby zastąpić funkcje zarządzania energią systemu. - printerProvider
-
Chrome 44 lub nowszy
Interfejs
chrome.printerProviderAPI 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.printingAPI, aby wysyłać zadania drukowania do drukarek zainstalowanych na Chromebooku. - printingMetrics
-
Użyj interfejsu
chrome.printingMetricsAPI, aby pobrać dane o korzystaniu z drukowania. - prywatność
-
Użyj interfejsu
chrome.privacyAPI, 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.processesAPI, aby wchodzić w interakcje z procesami przeglądarki. - proxy
-
Użyj interfejsu
chrome.proxyAPI, aby zarządzać ustawieniami serwera proxy w Chrome. Ten interfejs API korzysta z prototypu ChromeSetting interfejsu API typu do pobierania i ustawiania konfiguracji serwera proxy. - runtime
-
Użyj interfejsu API
chrome.runtime, aby pobrać proces roboczy usługi, zwrócić szczegóły manifestu oraz nasłuchiwać zdarzeń w cyklu życia rozszerzenia i na nie odpowiadać. Możesz też użyć tego interfejsu API, aby przekonwertować ścieżkę względną adresów URL na pełne adresy URL. - search
-
Chrome w wersji 87 lub nowszej
Użyj interfejsu
chrome.searchAPI, aby wyszukiwać za pomocą domyślnego dostawcy. - sesje,
-
Użyj interfejsu
chrome.sessionsAPI, aby wysyłać zapytania i przywracać karty oraz okna z sesji przeglądania. - storage
-
Używaj interfejsu
chrome.storageAPI do przechowywania, pobierania i śledzenia zmian w danych użytkowników. - system.cpu
-
Użyj interfejsu
system.cpuAPI, aby wysyłać zapytania o metadane procesora. - system.display
-
Użyj interfejsu
system.displayAPI, aby wysyłać zapytania o metadane wyświetlania. - system.memory
-
Interfejs API
chrome.system.memory. - system.storage
-
Użyj interfejsu
chrome.system.storageAPI, 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
-
Użyj interfejsu
chrome.systemLogAPI, aby rejestrować logi systemowe Chrome z rozszerzeń. - tabCapture
-
Użyj interfejsu
chrome.tabCaptureAPI, aby korzystać ze strumieni multimediów z kart. - karty,
-
Używaj interfejsu
chrome.tabsAPI do interakcji z systemem kart przeglądarki. Za pomocą tego interfejsu API możesz tworzyć, modyfikować i przenosić karty w przeglądarce. - topSites
-
Użyj interfejsu
chrome.topSitesAPI, 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.ttsAPI, aby odtwarzać zsyntetyzowany tekst zamieniony na mowę (TTS). Zobacz też powiązany interfejsttsEngineAPI, który umożliwia rozszerzeniu wdrożenie silnika mowy. - ttsEngine
-
Użyj interfejsu
chrome.ttsEngineAPI, 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 interfejsuttsAPI do generowania mowy. Rozszerzenie może następnie użyć dowolnej dostępnej technologii internetowej do syntezy i odtwarzania mowy oraz wysyłania zdarzeń z powrotem do funkcji wywołującej, aby zgłaszać stan. - types
-
Interfejs
chrome.typesAPI zawiera deklaracje typów dla Chrome. - vpnProvider
-
Chrome 43 lub nowszy Tylko ChromeOS
Użyj interfejsu
chrome.vpnProviderAPI, aby wdrożyć klienta VPN. - tapeta
-
Chrome 43 lub nowszy Tylko ChromeOS
Użyj interfejsu
chrome.wallpaperAPI, aby zmienić tapetę w ChromeOS. - webNavigation
-
Używaj interfejsu
chrome.webNavigationAPI, aby otrzymywać powiadomienia o stanie żądań nawigacyjnych w trakcie lotu. - webRequest
-
Użyj interfejsu
chrome.webRequestAPI, aby obserwować i analizować ruch oraz przechwytywać, blokować lub modyfikować żądania w trakcie przesyłania. - okna
-
Używaj interfejsu
chrome.windowsAPI do interakcji z oknami przeglądarki. Za pomocą tego interfejsu API możesz tworzyć, modyfikować i przenosić okna w przeglądarce.