Opis
Interfejs API chrome.tabs
umożliwia interakcję z systemem kart przeglądarki. Przy użyciu tego interfejsu API możesz tworzyć, modyfikować i zmieniać kolejność kart w przeglądarce.
Interfejs Tabs API nie tylko umożliwia manipulowanie kartami i zarządzanie nimi, ale też wykrywanie języka kart, robienie zrzutów ekranu i komunikowanie się ze skryptami zawartości karty.
Uprawnienia
Większość funkcji nie wymaga uprawnień do korzystania. Może to być na przykład utworzenie nowej karty, ponowne jej wczytanie lub przejście pod inny adres URL.
Podczas pracy z interfejsem Tabs API deweloperzy powinni znać 3 uprawnienia.
- Uprawnienie „Karty”
To uprawnienie nie przyznaje dostępu do przestrzeni nazw
chrome.tabs
. Zamiast tego umożliwia rozszerzeniu wywoływanie funkcjitabs.query()
dla 4 poufnych usług w instancjachtabs.Tab
:url
,pendingUrl
,title
ifavIconUrl
.{ "name": "My extension", ... "permissions": [ "tabs" ], ... }
- Uprawnienia dotyczące hosta
Uprawnienia hosta umożliwiają rozszerzeniu odczytywanie 4 poufnych właściwości
tabs.Tab
pasującej karty i wysyłanie dotyczących ich zapytań. Mogą też wchodzić w bezpośrednie interakcje z pasującymi kartami za pomocą takich metod jaktabs.captureVisibleTab()
,tabs.executeScript()
,tabs.insertCSS()
czytabs.removeCSS()
.{ "name": "My extension", ... "host_permissions": [ "http://*/*", "https://*/*" ], ... }
- Uprawnienie „activeTab”
W odpowiedzi na wywołanie użytkownika
activeTab
przyznaje temu rozszerzeniu tymczasowe uprawnienia hosta dla bieżącej karty. W przeciwieństwie do uprawnień hostaactiveTab
nie wywołuje żadnych ostrzeżeń.{ "name": "My extension", ... "permissions": [ "activeTab" ], ... }
Przypadki użycia
W sekcjach poniżej znajdziesz kilka typowych przypadków użycia.
Otwieranie strony rozszerzenia w nowej karcie
Częstym wzorcem używania rozszerzeń jest otwieranie strony wprowadzającej w nowej karcie, gdy dane rozszerzenie jest zainstalowane. Poniższy przykład pokazuje, jak to zrobić.
background.js:
chrome.runtime.onInstalled.addListener(({reason}) => {
if (reason === 'install') {
chrome.tabs.create({
url: "onboarding.html"
});
}
});
Pobierz bieżącą kartę
Ten przykład pokazuje, jak skrypt service worker rozszerzenia może pobrać aktywną kartę z aktualnie wybranego okna (lub ostatnio wybranego okna, jeśli nie jest zaznaczone żadne okno Chrome). Zwykle można ją określić jako bieżącą kartę użytkownika.
async function getCurrentTab() {
let queryOptions = { active: true, lastFocusedWindow: true };
// `tab` will either be a `tabs.Tab` instance or `undefined`.
let [tab] = await chrome.tabs.query(queryOptions);
return tab;
}
function getCurrentTab(callback) {
let queryOptions = { active: true, lastFocusedWindow: true };
chrome.tabs.query(queryOptions, ([tab]) => {
if (chrome.runtime.lastError)
console.error(chrome.runtime.lastError);
// `tab` will either be a `tabs.Tab` instance or `undefined`.
callback(tab);
});
}
Wycisz wybraną kartę
Ten przykład pokazuje, jak rozszerzenie może przełączać stan wyciszenia na danej karcie.
async function toggleMuteState(tabId) {
const tab = await chrome.tabs.get(tabId);
const muted = !tab.mutedInfo.muted;
await chrome.tabs.update(tabId, {muted});
console.log(`Tab ${tab.id} is ${muted ? "muted" : "unmuted"}`);
}
function toggleMuteState(tabId) {
chrome.tabs.get(tabId, async (tab) => {
let muted = !tab.mutedInfo.muted;
await chrome.tabs.update(tabId, { muted });
console.log(`Tab ${tab.id} is ${ muted ? "muted" : "unmuted" }`);
});
}
Przenieś bieżącą kartę na pierwszą pozycję po kliknięciu
Ten przykład pokazuje, jak przenieść kartę w trakcie przeciągania. Chociaż w tym przykładzie użyto funkcji chrome.tabs.move
, możesz użyć tego samego wzorca oczekiwania dla innych wywołań, które modyfikują karty podczas przeciągania.
chrome.tabs.onActivated.addListener(moveToFirstPosition);
async function moveToFirstPosition(activeInfo) {
try {
await chrome.tabs.move(activeInfo.tabId, {index: 0});
console.log("Success.");
} catch (error) {
if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
setTimeout(() => moveToFirstPosition(activeInfo), 50);
} else {
console.error(error);
}
}
}
chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);
function moveToFirstPositionMV2(activeInfo) {
chrome.tabs.move(activeInfo.tabId, { index: 0 }, () => {
if (chrome.runtime.lastError) {
const error = chrome.runtime.lastError;
if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
setTimeout(() => moveToFirstPositionMV2(activeInfo), 50);
} else {
console.error(error);
}
} else {
console.log("Success.");
}
});
}
Przekaż wiadomość do skryptu zawierającego treść wybranej karty
Ten przykład pokazuje, jak skrypt service worker rozszerzenia może komunikować się ze skryptami treści na określonych kartach przeglądarki za pomocą wywołania tabs.sendMessage()
.
function sendMessageToActiveTab(message) {
const [tab] = await chrome.tabs.query({ active: true, lastFocusedWindow: true });
const response = await chrome.tabs.sendMessage(tab.id, message);
// TODO: Do something with the response.
}
Przykłady rozszerzeń
Aby zobaczyć więcej demonstracji rozszerzeń interfejsu Tabs API, zapoznaj się z tymi materiałami:
Typy
MutedInfo
Stan wyciszenia karty i przyczyna ostatniej zmiany stanu.
Właściwości
-
extensionId
ciąg znaków opcjonalny
Identyfikator rozszerzenia, które zmieniło stan wyciszenia. Nie ustawiono, jeśli przyczyną ostatniej zmiany stanu wyciszenia nie było rozszerzenie.
-
Wyciszono
boolean
Określa, czy karta jest wyciszona (uniemożliwi odtwarzanie dźwięku). Karta może być wyciszona, nawet jeśli nie została odtworzona lub nie odtwarza dźwięku. Odpowiednik tego, czy świeci się wskaźnik „wyciszonego dźwięku”.
-
powód
opcjonalny MutedInfoReason
Przyczyna wyciszenia lub wyłączenia wyciszenia karty. Nie ustawiono, jeśli stan wyciszenia karty nigdy nie był zmieniany.
MutedInfoReason
Zdarzenie, które spowodowało zmianę stanu wyciszenia.
Typ wyliczeniowy
"user"
Działanie wejściowe użytkownika ustawiło stan wyciszenia.
"capture"
Rozpoczęto przechwytywanie karty, wymuszając zmianę stanu wyciszenia.
„extension”
Rozszerzenie identyfikowane przez pole ExtensionsId ustawia stan wyciszenia.
Tab
Właściwości
-
aktywny krok
boolean
Określa, czy karta jest aktywna w oknie. Nie musi to oznaczać, że okno jest zaznaczone.
-
audible
wartość logiczna opcjonalna
Chrome 45 i nowsze wersjeOkreśla, czy w ciągu ostatnich kilku sekund karta wygenerowała dźwięk (ale może nie być słyszalny, jeśli jest też wyciszony). Odpowiednik tego, czy świeci się wskaźnik „Dźwięk głośnika”.
-
autoDiscardable
boolean
Chrome w wersji 54 i nowszychOkreśla, czy karta może zostać automatycznie odrzucona przez przeglądarkę przy niskim poziomie zasobów.
-
odrzucono
boolean
Chrome w wersji 54 i nowszychWskazuje, czy karta została odrzucona. Karta odrzucona to taka, której zawartość została wyładowana z pamięci, ale nadal jest widoczna na pasku kart. Jego zawartość zostanie wczytana ponownie przy następnym aktywacji.
-
favIconUrl
ciąg znaków opcjonalny
Adres URL favikony karty. Ta właściwość jest dostępna tylko wtedy, gdy plik manifestu rozszerzenia zawiera uprawnienie
"tabs"
. Pusty ciąg może też być pusty podczas wczytywania karty. -
groupId
Liczba
Chrome 88 i nowsze wersjeIdentyfikator grupy, do której należy karta.
-
wysokość
Liczba opcjonalnie
Wysokość karty w pikselach.
-
wyróżniona
boolean
Określa, czy karta jest podświetlona.
-
id
Liczba opcjonalnie
Identyfikator karty. Identyfikatory kart są unikalne w ramach sesji przeglądarki. W pewnych okolicznościach do karty może nie być przypisany identyfikator, np. podczas wysyłania zapytań dotyczących obcych kart za pomocą interfejsu API
sessions
, co oznacza, że może być widoczny identyfikator sesji. Identyfikator karty można też ustawić nachrome.tabs.TAB_ID_NONE
w przypadku okien aplikacji i narzędzi deweloperskich. -
incognito
boolean
Informacja, czy karta jest w oknie incognito.
-
indeks
Liczba
Indeks zaczynający się od zera karty znajdującej się w jej oknie.
-
lastAccessed
Liczba opcjonalnie
Chrome 121 i nowsze wersjeCzas ostatniego uzyskania dostępu do karty jako liczba milisekund od początku epoki.
-
mutedInfo
Opcjonalny MutedInfo
Chrome 46 i nowsze wersjeStan wyciszenia karty i przyczyna ostatniej zmiany stanu.
-
openerTabId
Liczba opcjonalnie
Identyfikator karty, na której została otwarta (jeśli istnieje). Ta właściwość występuje tylko wtedy, gdy nadal istnieje karta otwierająca.
-
pendingUrl
ciąg znaków opcjonalny
Chrome 79 i nowszeAdres URL, do którego prowadzi karta, zanim zostanie zatwierdzona. Ta właściwość jest dostępna tylko wtedy, gdy plik manifestu rozszerzenia zawiera uprawnienie
"tabs"
i oczekuje na nawigację. -
przypięty
boolean
Określa, czy karta jest przypięta.
-
zaznaczono
boolean
WycofanoUżyj adresu
tabs.Tab.highlighted
.Określa, czy karta jest wybrana.
-
sessionId
ciąg znaków opcjonalny
Identyfikator sesji używany do jednoznacznego identyfikowania karty uzyskanej z interfejsu API
sessions
. -
status
TabStatus opcjonalnie
Stan wczytywania karty.
-
title
ciąg znaków opcjonalny
Tytuł karty. Ta właściwość jest dostępna tylko wtedy, gdy plik manifestu rozszerzenia zawiera uprawnienie
"tabs"
. -
URL
ciąg znaków opcjonalny
Ostatni zatwierdzony adres URL głównej ramki karty. Ta właściwość jest dostępna tylko wtedy, gdy plik manifestu rozszerzenia zawiera uprawnienie
"tabs"
i może być pustym ciągiem znaków, jeśli karta nie została jeszcze zatwierdzona. Zobacz teżTab.pendingUrl
. -
szerokość
Liczba opcjonalnie
Szerokość karty w pikselach.
-
windowId
Liczba
Identyfikator okna zawierającego kartę.
TabStatus
Stan wczytywania karty.
Typ wyliczeniowy
WindowType
Typ okna.
Typ wyliczeniowy
"panel"
"devtools"
ZoomSettings
Określa sposób obsługi zmian powiększenia na karcie oraz zakres.
Właściwości
-
defaultZoomFactor
Liczba opcjonalnie
Chrome 43 i nowsze wersjeSłuży do zwracania domyślnego poziomu powiększenia dla bieżącej karty w wywołaniach tabulacji.getZoomSettings.
-
tryb
Opcjonalnie ZoomSettingsMode
Określa sposób obsługi zmian powiększenia, tj.który element odpowiada za rzeczywiste skalowanie strony. Wartość domyślna to
automatic
. -
zakres
ZoomSettingsScope opcjonalnie
Określa, czy zmiany powiększenia są stosowane w źródle strony czy mają efekt tylko na tej karcie. W trybie
automatic
domyślna wartość toper-origin
, a w przeciwnym razie wartośćper-tab
.
ZoomSettingsMode
Określa sposób obsługi zmian powiększenia, tj.który element odpowiada za rzeczywiste skalowanie strony. Wartość domyślna to automatic
.
Typ wyliczeniowy
"automatic"
Zmiany powiększenia są obsługiwane automatycznie przez przeglądarkę.
"manual"
Zastępuje automatyczną obsługę zmian powiększenia. Zdarzenie onZoomChange
będzie nadal wysyłane, a za nasłuchiwanie tego zdarzenia i ręczne skalowanie strony należy rozszerzenie. Ten tryb nie obsługuje powiększania w trybie per-origin
, dlatego ignoruje ustawienie powiększenia w scope
i przyjmuje wartość per-tab
.
"disable"
Wyłącza powiększenie karty. Karta wróci do domyślnego poziomu powiększenia, a wszystkie próby zmiany powiększenia zostaną zignorowane.
ZoomSettingsScope
Określa, czy zmiany powiększenia są stosowane w źródle strony czy mają efekt tylko na tej karcie. W trybie automatic
domyślna wartość to per-origin
, a w przeciwnym razie wartość per-tab
.
Typ wyliczeniowy
"per-origin"
Zmiany powiększenia pozostają zachowane w przypadku powiększonej strony, tzn. wszystkie pozostałe karty, które przeszły do tego samego źródła, również są powiększone. Co więcej, zmiany powiększenia w per-origin
są zapisywane razem ze źródłem, co oznacza, że podczas przechodzenia do innych stron w tym samym źródle są one powiększone do tego samego współczynnika powiększenia. Zakres per-origin
jest dostępny tylko w trybie automatic
.
"na kartę"
Zmiany powiększenia obowiązują tylko na tej karcie. Zmiany powiększenia na innych kartach nie mają wpływu na jej powiększenie. Poza tym zmiany powiększenia w per-tab
są resetowane podczas nawigacji; poruszanie się po karcie zawsze wczytuje strony z per-origin
współczynnikami powiększenia.
Właściwości
MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND
Maksymalna liczba wywołań funkcji captureVisibleTab
w ciągu sekundy. Usługa captureVisibleTab
jest droga i nie należy jej wywoływać zbyt często.
Wartość
2
TAB_ID_NONE
Identyfikator wskazujący brak karty przeglądarki.
Wartość
–1
TAB_INDEX_NONE
Indeks reprezentujący brak indeksu tabulacji na pasku tabulacji.
Wartość
–1
Metody
captureVisibleTab()
chrome.tabs.captureVisibleTab(
windowId?: number,
options?: ImageDetails,
callback?: function,
)
Przechwytuje obszar widoczny w aktualnie aktywnej karcie w określonym oknie. Aby wywołać tę metodę, rozszerzenie musi mieć uprawnienie <all_urls> lub activeTab. Oprócz witryn, do których rozszerzenia mają normalnie dostęp, ta metoda pozwala rozszerzeniom przechwytywać witryny wrażliwe, które podlegają innym ograniczeniom. Dotyczy to np. stron chrome:-scheme, stron innych rozszerzeń czy adresów URL danych. Te witryny poufne można przechwytywać tylko z uprawnieniami ActiveTab. Adresy URL plików można przechwytywać tylko wtedy, gdy rozszerzenie ma dostęp do plików.
Parametry
-
windowId
Liczba opcjonalnie
Okno docelowe. Domyślnie jest to bieżące okno.
-
Opcje
ImageDetails opcjonalnie
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(dataUrl: string) => void
-
dataUrl
string,
Adres URL danych, który koduje obraz widocznego obszaru przechwyconej karty. Może być przypisana do właściwości „src” elementu HTML
img
do wyświetlania.
-
Zwroty
-
Obietnica<string>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
connect()
chrome.tabs.connect(
tabId: number,
connectInfo?: object,
)
Łączy się ze skryptami treści na określonej karcie. Zdarzenie runtime.onConnect
jest uruchamiane w każdym skrypcie treści uruchomionym na określonej karcie dla bieżącego rozszerzenia. Aby dowiedzieć się więcej, przeczytaj artykuł Przesyłanie wiadomości w języku angielskim.
Parametry
-
tabId
Liczba
-
connectInfo
obiekt opcjonalnie
-
documentId
ciąg znaków opcjonalny
Chrome 106 i nowsze wersjeOtwórz port do określonego dokumentu identyfikowanego przez parametr
documentId
zamiast do wszystkich ramek na karcie. -
frameId
Liczba opcjonalnie
Otwórz port do konkretnej ramki identyfikowanej przez parametr
frameId
zamiast wszystkich ramek na karcie. -
nazwa
ciąg znaków opcjonalny
Jest przekazywany do onConnect na potrzeby skryptów treści, które nasłuchują zdarzenia połączenia.
-
Zwroty
-
Port, który może służyć do komunikacji ze skryptami treści działającymi na określonej karcie. Zdarzenie
runtime.Port
na porcie jest uruchamiane, gdy karta się zamknie lub nie istnieje.
create()
chrome.tabs.create(
createProperties: object,
callback?: function,
)
Tworzy nową kartę.
Parametry
-
createProperties
obiekt
-
aktywny krok
wartość logiczna opcjonalna
Określa, czy karta ma stać się kartą aktywną w oknie. Nie ma wpływu na to, czy okno jest zaznaczone (patrz
windows.update
). Wartość domyślna totrue
. -
indeks
Liczba opcjonalnie
Położenie karty w oknie. Podana wartość jest ograniczona do zakresu od zera do liczby znaków tabulacji w oknie.
-
openerTabId
Liczba opcjonalnie
Identyfikator karty, na której została otwarta. Jeśli określisz kartę otwierającą, musi ona znajdować się w tym samym oknie co nowo utworzona karta.
-
przypięty
wartość logiczna opcjonalna
Określa, czy karta ma być przypięta. Domyślna wartość to
false
-
zaznaczono
wartość logiczna opcjonalna
WycofanoUżyj wartości aktywne.
Określa, czy karta ma zostać wybrana w oknie. Domyślna wartość to
true
-
URL
ciąg znaków opcjonalny
Adres URL, pod który należy początkowo otworzyć kartę. Pełne adresy URL muszą zawierać schemat (np. „http://www.google.com”, a nie „www.google.com”). Względne adresy URL są podawane względem bieżącej strony w rozszerzeniu. Domyślna strona to strona nowej karty.
-
windowId
Liczba opcjonalnie
Okno, w którym ma zostać utworzona nowa karta. Domyślnie jest to bieżące okno.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(tab: Tab) => void
-
tab
Karta utworzona.
-
Zwroty
-
Promise<Tab>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
detectLanguage()
chrome.tabs.detectLanguage(
tabId?: number,
callback?: function,
)
Wykrywa główny język treści na karcie.
Parametry
-
tabId
Liczba opcjonalnie
Domyślnie jest to aktywna karta bieżącego okna.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(language: string) => void
-
language,
string,
Kod języka w formacie ISO, np.
en
lubfr
. Pełną listę języków obsługiwanych przez tę metodę znajdziesz w sekcji kLanguageInfoTable. Zaznaczone są kolumny od drugiej do czwartej, a zwracana jest pierwsza wartość niezawierająca wartości NULL. Nie dotyczy to języka chińskiego uproszczonego, w przypadku którego zwracana jest wartośćzh-CN
. W przypadku nieznanego/nieokreślonego języka zwracana jest wartośćund
.
-
Zwroty
-
Obietnica<string>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
discard()
chrome.tabs.discard(
tabId?: number,
callback?: function,
)
Usuwa kartę z pamięci. Odrzucone karty są nadal widoczne na pasku kart i są odświeżane po aktywowaniu.
Parametry
-
tabId
Liczba opcjonalnie
Identyfikator karty, którą chcesz odrzucić. Jeśli określisz kartę, zostanie ona odrzucona, chyba że jest aktywna lub odrzucona. Jeśli go pominiesz, przeglądarka odrzuci najmniej ważną kartę. Niepowodzenie, jeśli nie ma żadnych kart do odrzucenia.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(tab?: Tab) => void
-
tab
Tab opcjonalnie
Odrzucona karta, jeśli została odrzucona. W przeciwnym razie nie zdefiniowano jej wartości.
-
Zwroty
-
Promise<Tab | undefined>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
duplicate()
chrome.tabs.duplicate(
tabId: number,
callback?: function,
)
Powiela kartę.
Parametry
-
tabId
Liczba
Identyfikator karty do zduplikowania.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(tab?: Tab) => void
Zwroty
-
Promise<Tab | undefined>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
executeScript()
chrome.tabs.executeScript(
tabId?: number,
details: InjectDetails,
callback?: function,
)
Zastąpione przez scripting.executeScript
w platformie Manifest V3.
Wstawia na stronie kod JavaScript. Szczegółowe informacje znajdziesz w sekcji dotyczącej wstrzykiwania kodu w dokumencie o skryptach treści.
Parametry
-
tabId
Liczba opcjonalnie
Identyfikator karty, na której uruchom skrypt. Domyślnie jest to aktywna karta bieżącego okna.
-
szczegóły
Szczegóły skryptu, który ma zostać uruchomiony. Musisz ustawić kod lub właściwość pliku, ale nie można ustawić obu tych elementów jednocześnie.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(result?: any[]) => void
-
wynik
any[] opcjonalny
Wynik skryptu w każdej wstrzykniętej ramce.
-
Zwroty
-
Obietnica<any[] | undefined>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
get()
chrome.tabs.get(
tabId: number,
callback?: function,
)
Pobiera informacje o określonej karcie.
Parametry
-
tabId
Liczba
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(tab: Tab) => void
-
tab
-
Zwroty
-
Promise<Tab>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
getAllInWindow()
chrome.tabs.getAllInWindow(
windowId?: number,
callback?: function,
)
Użyj tabs.query
{windowId: windowId}
.
Pobiera szczegółowe informacje o wszystkich kartach w określonym oknie.
Parametry
-
windowId
Liczba opcjonalnie
Domyślnie jest to bieżące okno.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(tabs: Tab[]) => void
-
karty
Tab[]
-
Zwroty
-
Promise<Tab[]>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
getCurrent()
chrome.tabs.getCurrent(
callback?: function,
)
Pobiera kartę, z której jest wykonywane to wywołanie skryptu. Zwraca wartość undefined
, jeśli została wywołana z kontekstu innego niż karta (np. ze strony w tle lub widoku wyskakującego).
Parametry
Zwroty
-
Promise<Tab | undefined>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
getSelected()
chrome.tabs.getSelected(
windowId?: number,
callback?: function,
)
Użyj tabs.query
{active: true}
.
Pobiera kartę wybraną w określonym oknie.
Parametry
-
windowId
Liczba opcjonalnie
Domyślnie jest to bieżące okno.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(tab: Tab) => void
-
tab
-
Zwroty
-
Promise<Tab>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
getZoom()
chrome.tabs.getZoom(
tabId?: number,
callback?: function,
)
Pobiera bieżący współczynnik powiększenia określonej karty.
Parametry
-
tabId
Liczba opcjonalnie
Identyfikator karty, z której pochodzi bieżący współczynnik powiększenia. Domyślnie jest to karta aktywna w bieżącym oknie.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(zoomFactor: number) => void
-
zoomFactor
Liczba
Bieżący współczynnik powiększenia karty.
-
Zwroty
-
Obietnica<number>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
getZoomSettings()
chrome.tabs.getZoomSettings(
tabId?: number,
callback?: function,
)
Pobiera bieżące ustawienia powiększenia określonej karty.
Parametry
-
tabId
Liczba opcjonalnie
Identyfikator karty odpowiadającej bieżącym ustawieniom powiększenia. Domyślnie jest to aktywna karta bieżącego okna.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(zoomSettings: ZoomSettings) => void
-
zoomSettings
Bieżące ustawienia powiększenia karty.
-
Zwroty
-
Promise<ZoomSettings>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
goBack()
chrome.tabs.goBack(
tabId?: number,
callback?: function,
)
Jeśli jest dostępna, wróć na poprzednią stronę.
Parametry
-
tabId
Liczba opcjonalnie
Identyfikator karty, do której można przejść wstecz. Domyślnie jest to wybrana karta w bieżącym oknie.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Zwroty
-
Promise<void>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
goForward()
chrome.tabs.goForward(
tabId?: number,
callback?: function,
)
Jeśli jest dostępna, przejdź do następnej strony.
Parametry
-
tabId
Liczba opcjonalnie
Identyfikator karty, która służy do przejścia do przodu. Domyślnie jest to wybrana karta w bieżącym oknie.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Zwroty
-
Promise<void>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
group()
chrome.tabs.group(
options: object,
callback?: function,
)
Dodaje co najmniej 1 kartę do określonej grupy lub, jeśli nie określono żadnej grupy, dodaje karty do nowo utworzonej grupy.
Parametry
-
Opcje
obiekt
-
createProperties
obiekt opcjonalnie
Konfiguracje tworzenia grup. Nie można użyć, jeśli identyfikator grupy został już określony.
-
windowId
Liczba opcjonalnie
Okno nowej grupy. Domyślnie jest to bieżące okno.
-
-
groupId
Liczba opcjonalnie
Identyfikator grupy, do której chcesz dodać karty. Jeśli nie podasz żadnej wartości, zostanie utworzona nowa grupa.
-
tabIds
liczba | [liczba, ...liczba[]]
Identyfikator lub lista identyfikatorów kart, które chcesz dodać do określonej grupy.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(groupId: number) => void
-
groupId
Liczba
Identyfikator grupy, do której zostały dodane karty.
-
Zwroty
-
Obietnica<number>
Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
highlight()
chrome.tabs.highlight(
highlightInfo: object,
callback?: function,
)
Wyróżnia podane karty i wyróżnia pierwszą grupę. Karta nie będzie prawdopodobnie aktywna, jeśli jest aktywna.
Parametry
-
highlightInfo
obiekt
-
karty
liczba | liczba[]
Jeden lub więcej indeksów kart do wyróżnienia.
-
windowId
Liczba opcjonalnie
Okno zawierające karty.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(window: Window) => void
-
okno
Zawiera szczegółowe informacje o oknie, w którym zostały wyróżnione karty.
-
Zwroty
-
Obietnica<windows.Window>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
insertCSS()
chrome.tabs.insertCSS(
tabId?: number,
details: InjectDetails,
callback?: function,
)
Zastąpione przez scripting.insertCSS
w platformie Manifest V3.
Wstawia na stronie kod CSS. Style wstawione przy użyciu tej metody można usuwać za pomocą przycisku scripting.removeCSS
. Szczegółowe informacje znajdziesz w sekcji dotyczącej wstrzykiwania kodu w dokumencie o skryptach treści.
Parametry
-
tabId
Liczba opcjonalnie
Identyfikator karty, na której ma zostać wstawiony kod CSS. Domyślnie jest to aktywna karta bieżącego okna.
-
szczegóły
Szczegóły tekstu CSS do wstawienia. Musisz ustawić kod lub właściwość pliku, ale nie można ustawić obu tych elementów jednocześnie.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Zwroty
-
Promise<void>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
move()
chrome.tabs.move(
tabIds: number | number[],
moveProperties: object,
callback?: function,
)
Przenosi jedną lub więcej kart w nowe miejsce w oknie lub do nowego okna. Pamiętaj, że karty można przenosić tylko do i z zwykłych (window.type === "normal") okien.
Parametry
-
tabIds
liczba | liczba[]
Identyfikator karty lub lista identyfikatorów kart do przeniesienia.
-
moveProperties
obiekt
-
indeks
Liczba
Pozycja, do której ma zostać przeniesione okno. Użyj
-1
, by umieścić kartę na końcu okna. -
windowId
Liczba opcjonalnie
Domyślnie jest to okno, w którym znajduje się obecnie karta.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Zwroty
-
Chrome 88 i nowsze wersje
Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
query()
chrome.tabs.query(
queryInfo: object,
callback?: function,
)
Pobiera wszystkie karty z określonymi właściwościami lub wszystkie, jeśli nie określono żadnych właściwości.
Parametry
-
queryInfo
obiekt
-
aktywny krok
wartość logiczna opcjonalna
Określa, czy karty są aktywne w oknach.
-
audible
wartość logiczna opcjonalna
Chrome 45 i nowsze wersjeCzy karty są słyszalne.
-
autoDiscardable
wartość logiczna opcjonalna
Chrome w wersji 54 i nowszychOkreśla, czy karty mogą być automatycznie zamykane przez przeglądarkę przy niskim poziomie zasobów.
-
currentWindow
wartość logiczna opcjonalna
Określa, czy karty są w bieżącym oknie.
-
odrzucono
wartość logiczna opcjonalna
Chrome w wersji 54 i nowszychOkreśla, czy karty zostały odrzucone. Karta odrzucona to taka, której zawartość została wyładowana z pamięci, ale nadal jest widoczna na pasku kart. Jego zawartość zostanie wczytana ponownie przy następnym aktywacji.
-
groupId
Liczba opcjonalnie
Chrome 88 i nowsze wersjeIdentyfikator grupy, w której znajdują się karty, lub
tabGroups.TAB_GROUP_ID_NONE
– w przypadku rozgrupowanych kart. -
wyróżniona
wartość logiczna opcjonalna
Określa, czy karty są wyróżnione.
-
indeks
Liczba opcjonalnie
Pozycja kart w oknach.
-
lastFocusedWindow
wartość logiczna opcjonalna
Określa, czy karty są w ostatnim aktywnym oknie.
-
Wyciszono
wartość logiczna opcjonalna
Chrome 45 i nowsze wersjeOkreśla, czy karty są wyciszone.
-
przypięty
wartość logiczna opcjonalna
Określa, czy karty są przypięte.
-
status
TabStatus opcjonalnie
Stan wczytywania karty.
-
title
ciąg znaków opcjonalny
Dopasuj tytuły stron do wzorca. Ta właściwość jest ignorowana, jeśli rozszerzenie nie ma uprawnienia
"tabs"
. -
URL
string | string[] opcjonalny
Dopasuj karty do co najmniej jednego wzorca adresu URL. Identyfikatory fragmentów nie są zgodne. Ta właściwość jest ignorowana, jeśli rozszerzenie nie ma uprawnienia
"tabs"
. -
windowId
Liczba opcjonalnie
Identyfikator okna nadrzędnego lub
windows.WINDOW_ID_CURRENT
dla bieżącego okna. -
windowType
WindowType opcjonalnie
Typ okna, w którym znajdują się karty.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(result: Tab[]) => void
-
wynik
Tab[]
-
Zwroty
-
Promise<Tab[]>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
reload()
chrome.tabs.reload(
tabId?: number,
reloadProperties?: object,
callback?: function,
)
Załaduj ponownie kartę.
Parametry
-
tabId
Liczba opcjonalnie
Identyfikator karty, która ma zostać ponownie wczytana. Domyślnie jest to wybrana karta w bieżącym oknie.
-
reloadProperties
obiekt opcjonalnie
-
bypassCache
wartość logiczna opcjonalna
Określa, czy pomijać lokalne buforowanie. Domyślna wartość to
false
.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Zwroty
-
Promise<void>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
remove()
chrome.tabs.remove(
tabIds: number | number[],
callback?: function,
)
Zamyka co najmniej 1 kartę.
Parametry
-
tabIds
liczba | liczba[]
Identyfikator lub lista identyfikatorów kart do zamknięcia.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Zwroty
-
Promise<void>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
removeCSS()
chrome.tabs.removeCSS(
tabId?: number,
details: DeleteInjectionDetails,
callback?: function,
)
Zastąpione przez scripting.removeCSS
w platformie Manifest V3.
Usuwa element CSS strony, który został wcześniej wstrzyknięty przez wywołanie funkcji scripting.insertCSS
.
Parametry
-
tabId
Liczba opcjonalnie
Identyfikator karty, z której chcesz usunąć CSS. Domyślnie jest to aktywna karta bieżącego okna.
-
szczegóły
Szczegóły tekstu usługi porównywania cen do usunięcia. Musisz ustawić kod lub właściwość pliku, ale nie można ustawić obu tych elementów jednocześnie.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Zwroty
-
Promise<void>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
sendMessage()
chrome.tabs.sendMessage(
tabId: number,
message: any,
options?: object,
callback?: function,
)
Wysyła pojedynczą wiadomość do skryptów treści na określonej karcie z opcjonalnym wywołaniem zwrotnym, które zostanie wykonane po wysłaniu odpowiedzi. Zdarzenie runtime.onMessage
jest uruchamiane w każdym skrypcie treści uruchomionym na określonej karcie dla bieżącego rozszerzenia.
Parametry
-
tabId
Liczba
-
wiadomość
Dowolne
Wiadomość do wysłania. Ta wiadomość powinna być obiektem obsługującym format JSON.
-
Opcje
obiekt opcjonalnie
-
documentId
ciąg znaków opcjonalny
Chrome 106 i nowsze wersjeWyślij wiadomość do określonego dokumentu oznaczonego przez
documentId
zamiast do wszystkich ramek na karcie. -
frameId
Liczba opcjonalnie
Wyślij wiadomość do konkretnej ramki identyfikowanej przez parametr
frameId
zamiast do wszystkich ramek karty.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Chrome 99 i nowszeParametr
callback
wygląda tak:(response: any) => void
-
odpowiedź
Dowolne
Obiekt odpowiedzi JSON wysłany przez moduł obsługi wiadomości. Jeśli podczas nawiązywania połączenia z określoną kartą wystąpi błąd, wywołanie zwrotne jest wywoływane bez argumentów, a dla funkcji
runtime.lastError
jest ustawiany komunikat o błędzie.
-
Zwroty
-
Obietnica<jakikolwiek>
Chrome 99 i nowszeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
sendRequest()
chrome.tabs.sendRequest(
tabId: number,
request: any,
callback?: function,
)
Użyj adresu runtime.sendMessage
.
Wysyła jedno żądanie do skryptów treści na określonej karcie z opcjonalnym wywołaniem zwrotnym, które jest wykonywane po zwróceniu odpowiedzi. Zdarzenie extension.onRequest
jest uruchamiane w każdym skrypcie treści uruchomionym na określonej karcie dla bieżącego rozszerzenia.
Parametry
-
tabId
Liczba
-
Poproś
Dowolne
-
wywołanie zwrotne
funkcja opcjonalnie
Chrome 99 i nowszeParametr
callback
wygląda tak:(response: any) => void
-
odpowiedź
Dowolne
Obiekt odpowiedzi JSON wysłany przez moduł obsługi żądania. Jeśli podczas nawiązywania połączenia z określoną kartą wystąpi błąd, wywołanie zwrotne jest wywoływane bez argumentów, a dla funkcji
runtime.lastError
jest ustawiany komunikat o błędzie.
-
Zwroty
-
Obietnica<jakikolwiek>
Chrome 99 i nowszeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
setZoom()
chrome.tabs.setZoom(
tabId?: number,
zoomFactor: number,
callback?: function,
)
Powiększa określoną kartę.
Parametry
-
tabId
Liczba opcjonalnie
Identyfikator karty, którą chcesz powiększyć. Domyślnie jest to aktywna karta bieżącego okna.
-
zoomFactor
Liczba
Nowy współczynnik powiększenia. Wartość
0
ustawia bieżący domyślny współczynnik powiększenia. Wartości większe niż0
określają (prawdopodobnie inny niż domyślny) współczynnik powiększenia dla karty. -
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Zwroty
-
Promise<void>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
setZoomSettings()
chrome.tabs.setZoomSettings(
tabId?: number,
zoomSettings: ZoomSettings,
callback?: function,
)
Ustawia ustawienia powiększenia dla określonej karty, które określają sposób obsługi zmian powiększenia. Te ustawienia są resetowane do wartości domyślnych podczas poruszania się po karcie.
Parametry
-
tabId
Liczba opcjonalnie
Identyfikator karty, na której chcesz zmienić ustawienia powiększenia. Domyślnie jest to aktywna karta bieżącego okna.
-
zoomSettings
Określa sposób i zakres obsługi zmian powiększenia.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Zwroty
-
Promise<void>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
ungroup()
chrome.tabs.ungroup(
tabIds: number | [number, ...number[]],
callback?: function,
)
Usuwa co najmniej 1 kartę z odpowiedniej grupy. Jeśli jakieś grupy staną się puste, zostaną usunięte.
Parametry
-
tabIds
liczba | [liczba, ...liczba[]]
Identyfikator lub lista identyfikatorów kart do usunięcia z odpowiednich grup.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Zwroty
-
Promise<void>
Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
update()
chrome.tabs.update(
tabId?: number,
updateProperties: object,
callback?: function,
)
Modyfikuje właściwości karty. Właściwości, które nie są określone w polu updateProperties
, nie są modyfikowane.
Parametry
-
tabId
Liczba opcjonalnie
Domyślnie jest to wybrana karta w bieżącym oknie.
-
updateProperties
obiekt
-
aktywny krok
wartość logiczna opcjonalna
Określa, czy karta ma być aktywna. Nie ma wpływu na to, czy okno jest aktywne (patrz
windows.update
). -
autoDiscardable
wartość logiczna opcjonalna
Chrome w wersji 54 i nowszychOkreśla, czy karta ma być automatycznie odrzucana przy niskim poziomie zasobów.
-
wyróżniona
wartość logiczna opcjonalna
Dodaje lub usuwa kartę z bieżącego wyboru.
-
Wyciszono
wartość logiczna opcjonalna
Chrome 45 i nowsze wersjeOkreśla, czy karta ma być wyciszona.
-
openerTabId
Liczba opcjonalnie
Identyfikator karty, na której została otwarta. Jeśli została określona, karta otwierająca musi znajdować się w tym samym oknie co ta karta.
-
przypięty
wartość logiczna opcjonalna
Określa, czy karta ma być przypięta.
-
zaznaczono
wartość logiczna opcjonalna
WycofanoUżyj opcji highlighted (podświetlone).
Określa, czy karta ma zostać wybrana.
-
URL
ciąg znaków opcjonalny
Adres URL, do którego należy przejść na kartę. Adresy URL JavaScript nie są obsługiwane. Zamiast nich użyj parametru
scripting.executeScript
.
-
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(tab?: Tab) => void
Zwroty
-
Promise<Tab | undefined>
Chrome 88 i nowsze wersjeObietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.
Wydarzenia
onActivated
chrome.tabs.onActivated.addListener(
callback: function,
)
Uruchamiany po zmianie aktywnej karty w oknie. Pamiętaj, że URL karty może nie być ustawiony w chwili uruchomienia tego zdarzenia, ale możesz nasłuchiwać zdarzeń onUpdated, aby otrzymywać powiadomienia o ustawieniu adresu URL.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(activeInfo: object) => void
-
activeInfo
obiekt
-
tabId
Liczba
Identyfikator aktywnej karty.
-
windowId
Liczba
Identyfikator okna, w którym została zmieniona aktywna karta.
-
-
onActiveChanged
chrome.tabs.onActiveChanged.addListener(
callback: function,
)
Użyj adresu tabs.onActivated
.
Uruchamiany po zmianie karty w oknie. Pamiętaj, że URL karty może nie być ustawiony w chwili uruchomienia tego zdarzenia, ale możesz nasłuchiwać zdarzeń tabs.onUpdated
, aby otrzymać powiadomienie, gdy URL zostanie ustawiony.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(tabId: number, selectInfo: object) => void
-
tabId
Liczba
-
selectInfo
obiekt
-
windowId
Liczba
Identyfikator okna, w którym zmieniła się wybrana karta.
-
-
onAttached
chrome.tabs.onAttached.addListener(
callback: function,
)
Uruchamiane, gdy karta jest dołączona do okna, na przykład po przeniesieniu jej między oknami.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(tabId: number, attachInfo: object) => void
-
tabId
Liczba
-
attachInfo
obiekt
-
newPosition
Liczba
-
newWindowId
Liczba
-
-
onCreated
chrome.tabs.onCreated.addListener(
callback: function,
)
Uruchamiane po utworzeniu karty. Pamiętaj, że URL karty i członkostwo w grupie kart mogą nie być ustawione w momencie wywoływania tego zdarzenia, ale możesz nasłuchiwać zdarzeń onUpdated, aby otrzymać powiadomienie o ustawieniu adresu URL lub dodaniu karty do grupy kart.
onDetached
chrome.tabs.onDetached.addListener(
callback: function,
)
Uruchamiane, gdy karta została odłączona od okna, na przykład po przeniesieniu między oknami.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(tabId: number, detachInfo: object) => void
-
tabId
Liczba
-
detachInfo
obiekt
-
oldPosition
Liczba
-
oldWindowId
Liczba
-
-
onHighlightChanged
chrome.tabs.onHighlightChanged.addListener(
callback: function,
)
Użyj adresu tabs.onHighlighted
.
Uruchamiane po zmianie wyróżnionych lub wybranych kart w oknie.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(selectInfo: object) => void
-
selectInfo
obiekt
-
tabIds
liczba[]
Wszystkie wyróżnione karty w oknie.
-
windowId
Liczba
Okno, którego karty się zmieniły.
-
-
onHighlighted
chrome.tabs.onHighlighted.addListener(
callback: function,
)
Uruchamiane po zmianie wyróżnionych lub wybranych kart w oknie.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(highlightInfo: object) => void
-
highlightInfo
obiekt
-
tabIds
liczba[]
Wszystkie wyróżnione karty w oknie.
-
windowId
Liczba
Okno, którego karty się zmieniły.
-
-
onMoved
chrome.tabs.onMoved.addListener(
callback: function,
)
Uruchamiane, gdy karta zostanie przeniesiona w oknie. Uruchamiane jest tylko jedno zdarzenie przeniesienia reprezentujące kartę przeniesioną bezpośrednio przez użytkownika. Zdarzenia przenoszenia nie są wywoływane w przypadku innych kart, które muszą zostać przeniesione w odpowiedzi na przeniesioną ręcznie kartę. To zdarzenie nie jest wywoływane po przeniesieniu karty między oknami. Szczegółowe informacje znajdziesz w sekcji tabs.onDetached
.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(tabId: number, moveInfo: object) => void
-
tabId
Liczba
-
moveInfo
obiekt
-
fromIndex
Liczba
-
toIndex
Liczba
-
windowId
Liczba
-
-
onRemoved
chrome.tabs.onRemoved.addListener(
callback: function,
)
Uruchamiane, gdy karta jest zamknięta.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(tabId: number, removeInfo: object) => void
-
tabId
Liczba
-
removeInfo
obiekt
-
isWindowClosing
boolean
Prawda, gdy karta została zamknięta z powodu zamknięcia jej okna nadrzędnego.
-
windowId
Liczba
Okno, którego karta jest zamknięta.
-
-
onReplaced
chrome.tabs.onReplaced.addListener(
callback: function,
)
Uruchamiane, gdy karta zostaje zastąpiona inną kartą w związku z renderowaniem wstępnym lub błyskawicznym.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(addedTabId: number, removedTabId: number) => void
-
addedTabId
Liczba
-
removedTabId
Liczba
-
onSelectionChanged
chrome.tabs.onSelectionChanged.addListener(
callback: function,
)
Użyj adresu tabs.onActivated
.
Uruchamiany po zmianie karty w oknie.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(tabId: number, selectInfo: object) => void
-
tabId
Liczba
-
selectInfo
obiekt
-
windowId
Liczba
Identyfikator okna, w którym zmieniła się wybrana karta.
-
-
onUpdated
chrome.tabs.onUpdated.addListener(
callback: function,
)
Uruchamiane po zaktualizowaniu karty.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(tabId: number, changeInfo: object, tab: Tab) => void
-
tabId
Liczba
-
changeInfo
obiekt
-
audible
wartość logiczna opcjonalna
Chrome 45 i nowsze wersjeNowy stan karty z dźwiękiem.
-
autoDiscardable
wartość logiczna opcjonalna
Chrome w wersji 54 i nowszychNowy stan karty do automatycznego wyłączenia.
-
odrzucono
wartość logiczna opcjonalna
Chrome w wersji 54 i nowszychNowy stan karty po odrzuceniu.
-
favIconUrl
ciąg znaków opcjonalny
Adres URL nowej favikony karty.
-
groupId
Liczba opcjonalnie
Chrome 88 i nowsze wersjeNowa grupa dla karty.
-
mutedInfo
Opcjonalny MutedInfo
Chrome 46 i nowsze wersjeNowy stan wyciszenia karty i przyczyna zmiany.
-
przypięty
wartość logiczna opcjonalna
Nowy stan przypięcia karty.
-
status
TabStatus opcjonalnie
Stan wczytywania karty.
-
title
ciąg znaków opcjonalny
Chrome 48 i nowsze wersjeNowy tytuł karty.
-
URL
ciąg znaków opcjonalny
adres URL karty, jeśli uległ zmianie;
-
-
tab
-
onZoomChange
chrome.tabs.onZoomChange.addListener(
callback: function,
)
Uruchamiane, gdy karta jest powiększona.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(ZoomChangeInfo: object) => void
-
ZoomChangeInfo
obiekt
-
newZoomFactor
Liczba
-
oldZoomFactor
Liczba
-
tabId
Liczba
-
zoomSettings
-
-