Opis
Interfejs API chrome.tabs
umożliwia interakcję z systemem kart przeglądarki. Możesz używać tego interfejsu API do tworzenia, modyfikowania i przesuwania kart w przeglądarce.
Interfejs Tabs API nie tylko oferuje funkcje do manipulowania kartami i zarządzania nimi, ale też może wykrywać język karty, zrób zrzut ekranu i komunikacji za pomocą skryptów treści karty.
Uprawnienia
Korzystanie z większości funkcji nie wymaga uprawnień. Na przykład: tworzenie nowej karty, ponowne wczytanie karty, przejście pod inny adres URL itp.
Deweloperzy korzystający z interfejsu Tabs API powinni mieć świadomość 3 uprawnień.
- „Karty” uprawnienia
To uprawnienie nie daje dostępu do przestrzeni nazw
chrome.tabs
. Zamiast tego daje przedłużeniu możliwość wywołania funkcjitabs.query()
do czterech właściwości o charakterze kontrowersyjnym w instancjachtabs.Tab
:url
,pendingUrl
,title
ifavIconUrl
.{ "name": "My extension", ... "permissions": [ "tabs" ], ... }
- Uprawnienia hosta
Uprawnienia hosta umożliwiają rozszerzeniu odczytywanie 4 poufnych danych karty i wysyłanie dotyczących jej zapytań Usługi:
tabs.Tab
. Mogą też wchodzić w bezpośrednią interakcję z pasującymi kartami za pomocą takich metod jak jakotabs.captureVisibleTab()
,tabs.executeScript()
,tabs.insertCSS()
itabs.removeCSS()
.{ "name": "My extension", ... "host_permissions": [ "http://*/*", "https://*/*" ], ... }
- Karta „activeTab” uprawnienia
activeTab
przyznaje rozszerzeniu tymczasowe uprawnienia do hosta dla bieżącej karty w odpowiedź na wywołanie użytkownika. W przeciwieństwie do uprawnień hostaactiveTab
nie wywołuje żadnych ostrzeżeń.{ "name": "My extension", ... "permissions": [ "activeTab" ], ... }
Przypadki użycia
W sekcjach poniżej przedstawiliśmy niektóre typowe przypadki użycia.
Otwórz stronę rozszerzenia w nowej karcie
Typowym wzorcem używania rozszerzeń jest otwieranie strony wprowadzającej w nowej karcie, gdy rozszerzenie jest Zainstalowano. Z przykładu poniżej dowiesz się, 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 metody aktualnie wybrane okno (lub ostatnie, jeśli nie jest zaznaczone żadne okno Chrome). Ten zwykle jest uznawana za 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 określoną 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" }`);
});
}
Przesuń bieżącą kartę na pierwszą pozycję po kliknięciu
Ten przykład pokazuje, jak przenieść kartę, gdy trwa przeciąganie lub nie. Choć w tym przykładzie
używa chrome.tabs.move
, możesz użyć tego samego wzorca oczekiwania w przypadku innych wywołań, które modyfikują karty podczas
trwa przeciąganie.
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 treści 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ą interfejsu 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ń
Więcej wersji demonstracyjnych rozszerzeń interfejsu Tabs API znajdziesz w tych wersjach:
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. Wartość nie jest ustawiona, jeśli stan wyciszenia nie zmienił się ostatnio po zastosowaniu rozszerzenia.
-
Wyciszono
wartość logiczna
Określa, czy karta jest wyciszona (nie może odtwarzać dźwięku). Karta może być wyciszona, nawet jeśli nie została odtworzona lub nie odtwarza obecnie dźwięku. Odpowiednik tego, czy opcja „wyciszono” wskaźnik dźwięku jest widoczny.
-
powód
Opcjonalne MutedInfoReason
Powód wyciszenia lub wyłączenia wyciszenia karty. Wartość nie jest ustawiona, jeśli stan wyciszenia karty nigdy się nie zmieniał.
MutedInfoReason
Zdarzenie, które spowodowało zmianę stanu wyciszenia.
Typ wyliczeniowy
"user"
Działanie wprowadzone przez użytkownika powoduje ustawienie wyciszenia.
"capture"
Rozpoczęto przechwytywanie karty, co wymusiło zmianę stanu wyciszenia.
"extension"
Rozszerzenie, które jest określane przez pole extensionId, służy do ustawiania stanu wyciszenia.
Tab
Właściwości
-
aktywna
wartość logiczna
Określa, czy karta jest aktywna w swoim oknie. Nie musi to oznaczać, że okno jest zaznaczone.
-
audible
Wartość logiczna opcjonalna
Chrome w wersji 45 lub nowszej .Określa, czy w ciągu ostatnich kilku sekund karta generowała dźwięk (ale może nie być słyszalna, jeśli została wyciszona). Odpowiednik ustawienia atrybutu „dźwięk z głośnika” wyświetlany jest wskaźnik.
-
autoDiscardable
wartość logiczna
Chrome w wersji 54 lub nowszej .Określa, czy karta może zostać automatycznie odrzucona przez przeglądarkę przy niskim poziomie zasobów.
-
odrzucono
wartość logiczna
Chrome w wersji 54 lub nowszej .Określa, czy karta została odrzucona. Odrzucona karta to taka, której zawartość została wyładowana z pamięci, ale nadal widoczna na pasku kart. Zawartość zostanie wczytana ponownie, gdy następnym razem ją aktywujesz.
-
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"
. Jeśli karta się wczytuje, może też być pusty. -
groupId
liczba
Chrome 88 i nowsze .Identyfikator grupy, do której należy karta.
-
wysokość
liczba opcjonalnie
Wysokość karty w pikselach.
-
wyróżniona
wartość logiczna
Określa, czy karta jest wyróżniona.
-
id
liczba opcjonalnie
Identyfikator karty. Identyfikatory kart są unikalne w obrębie sesji przeglądarki. W pewnych okolicznościach do karty może nie zostać przypisany identyfikator. na przykład podczas wysyłania zapytań dotyczących obcych kart przy użyciu interfejsu API
sessions
, który może zawierać identyfikator sesji. Identyfikator karty można też ustawić nachrome.tabs.TAB_ID_NONE
w przypadku okien aplikacji i narzędzi deweloperskich. -
incognito
wartość logiczna
Określa, czy karta jest w oknie incognito.
-
indeks
liczba
Indeks karty w jej oknie liczony od zera.
-
lastAccessed
liczba
Chrome w wersji 121 lub nowszej .Ostatni raz, gdy karta została otwarta, jako liczba milisekund od początku epoki.
-
mutedInfo
MutedInfo opcjonalne
Chrome w wersji 46 lub nowszej, .Stan wyciszenia karty i przyczyna ostatniej zmiany stanu.
-
openerTabId
liczba opcjonalnie
Identyfikator karty, która otworzyła tę kartę (jeśli istnieje). Ta właściwość jest dostępna tylko wtedy, gdy nadal istnieje karta otwierająca.
-
pendingUrl
ciąg znaków opcjonalny
Chrome w wersji 79 lub nowszej .Adres URL, do którego prowadzi karta, przed zatwierdzeniem. Ta właściwość jest dostępna tylko wtedy, gdy plik manifestu rozszerzenia zawiera uprawnienie
"tabs"
i oczekuje na nawigację. -
przypięty
wartość logiczna
Określa, czy karta jest przypięta.
-
wybrano
wartość logiczna
WycofanoUżyj adresu
tabs.Tab.highlighted
.Określa, czy karta jest wybrana.
-
sessionId
ciąg znaków opcjonalny
Identyfikator sesji używany do jednoznacznej identyfikacji karty uzyskanej z interfejsu API
sessions
. -
status
TabStatus (opcjonalny)
Stan wczytywania karty.
-
tytuł
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
"unload"
"loading"
"complete"
WindowType
Typ okna.
Typ wyliczeniowy
"normal"
"wyskakujące okienko"
"panel"
"app"
"narzędzia deweloperskie"
ZoomSettings
Określa zakres i sposób obsługi zmian powiększenia na karcie.
Właściwości
-
defaultZoomFactor
liczba opcjonalnie
Chrome w wersji 43 lub nowszej .Służy do przywracania domyślnego poziomu powiększenia dla bieżącej karty w wywołaniach tab.getZoomSettings.
-
tryb
ZoomSettingsMode optional
Określa sposób obsługi zmian powiększenia, tzn.która encja jest odpowiedzialna za rzeczywiste skalowanie strony. domyślna wartość to
automatic
. -
zakres
Opcjonalny ZoomSettingsScope
Określa, czy zmiany powiększenia pozostają niezmienione dla pochodzenia strony czy mają zastosowanie tylko na tej karcie. domyślnie ma wartość
per-origin
w trybieautomatic
. W przeciwnym razie ma wartośćper-tab
.
ZoomSettingsMode
Określa sposób obsługi zmian powiększenia, tzn.która encja jest odpowiedzialna za rzeczywiste skalowanie strony. domyślna wartość to automatic
.
Typ wyliczeniowy
"automatic"
Zmiany powiększenia są obsługiwane przez przeglądarkę automatycznie.
"manual"
Zastępuje automatyczną obsługę zmian powiększenia. Zdarzenie onZoomChange
nadal będzie wysyłane, a rozszerzeniem będzie odpowiadać za wykrywanie tego zdarzenia i ręczne skalowanie strony. Ten tryb nie obsługuje powiększania w trybie per-origin
, więc ignoruje ustawienie powiększenia scope
i przyjmuje wartość per-tab
.
"Disable"
Wyłącza całe powiększanie karty. Na karcie zostanie przywrócony domyślny poziom powiększenia, a wszystkie próby zmiany powiększenia zostaną zignorowane.
ZoomSettingsScope
Określa, czy zmiany powiększenia pozostają niezmienione dla pochodzenia strony czy mają zastosowanie tylko na tej karcie. domyślnie ma wartość per-origin
w trybie automatic
. W przeciwnym razie ma wartość per-tab
.
Typ wyliczeniowy
"per-origin"
Zmiany powiększenia utrzymują się w źródle powiększonej strony, co oznacza, że wszystkie pozostałe karty otwierane w tym samym miejscu również zostaną powiększone. Co więcej, zmiany powiększenia w elemencie per-origin
są zapisywane z pierwotnym punktem początkowym, co oznacza, że podczas przechodzenia na inne strony w tym samym punkcie początkowym wszystkie są powiększone z takim samym powiększeniem. Zakres per-origin
jest dostępny tylko w trybie automatic
.
"per-tab"
Zmiany powiększenia dotyczą tylko tej karty, a zmiany powiększenia na innych kartach nie mają wpływu na powiększenie tej karty. Dodatkowo zmiany powiększenia w per-tab
są resetowane podczas nawigacji. poruszanie się po karcie zawsze wczytuje strony z określonym współczynnikiem powiększenia (per-origin
).
Właściwości
MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND
Maksymalna liczba wywołań funkcji captureVisibleTab
na sekundę. Usługa captureVisibleTab
jest droga i nie należy jej wywoływać zbyt często.
Wartość
2
TAB_ID_NONE
Identyfikator, który odnosi się do braku karty przeglądarki.
Wartość
–1
TAB_INDEX_NONE
Indeks reprezentujący brak indeksu kart w pasku tab_strip.
Wartość
–1
Metody
captureVisibleTab()
chrome.tabs.captureVisibleTab(
windowId?: number,
options?: ImageDetails,
callback?: function,
)
Przechwytuje widoczny obszar aktualnie aktywnej karty w określonym oknie. Aby można było wywołać tę metodę, rozszerzenie musi mieć uprawnienie <all_urls> lub activeTab. Oprócz witryn, do których zwykle mają dostęp rozszerzenia, ta metoda umożliwia rozszerzeniom przechwytywanie poufnych witryn, które są objęte ograniczeniami w innych przypadkach, takich jak strony chrome:-scheme i inne rozszerzenia. a dane: adresy URL. Te poufne witryny można przechwytywać tylko przy użyciu uprawnienia ActiveTab. Adresy URL plików można przechwytywać tylko wtedy, gdy rozszerzenie otrzymało dostęp do plików.
Parametry
-
windowId
liczba opcjonalnie
Okno docelowe. Wartość domyślna to bieżące okno.
-
Opcje
ImageDetails opcjonalne
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(dataUrl: string) => void
-
dataUrl
ciąg znaków
Adres URL danych, który koduje obraz widocznego obszaru na przechwyconej karcie. Może być przypisany do parametru „src” właściwości elementu HTML
img
do wyświetlania.
-
Zwroty
-
Obietnica<ciąg>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
connect()
chrome.tabs.connect(
tabId: number,
connectInfo?: object,
)
Łączy ze skryptami treści na określonej karcie. Zdarzenie runtime.onConnect
jest wywoływane w każdym skrypcie treści działającym na określonej karcie bieżącego rozszerzenia. Więcej informacji znajdziesz w artykule Przesyłanie wiadomości na podstawie skryptu Content Script.
Parametry
-
tabId
liczba
-
connectInfo
obiekt opcjonalny
-
documentId
ciąg znaków opcjonalny
Chrome 106 lub nowszy .Zamiast wszystkich klatek na karcie otwórz port do określonego dokumentu określonego przez parametr
documentId
. -
frameId
liczba opcjonalnie
Zamiast wszystkich klatek na karcie otwórz port w konkretnej ramce identyfikowanej przez tag
frameId
. -
nazwa
ciąg znaków opcjonalny
Jest przekazywany do onConnect w przypadku 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 uruchomionymi na określonej karcie. Zdarzenie
runtime.Port
portu jest wywoływane, jeśli karta nie istnieje lub się zamyka.
create()
chrome.tabs.create(
createProperties: object,
callback?: function,
)
Tworzy nową kartę.
Parametry
-
createProperties
Obiekt
-
aktywna
Wartość logiczna opcjonalna
Określa, czy karta powinna stać się aktywną kartą w oknie. Nie ma wpływu na to, czy okno ma być aktywne (patrz
windows.update
). Domyślna wartość totrue
. -
indeks
liczba opcjonalnie
Pozycja karty w oknie. Podana wartość jest ograniczana do zakresu od 0 do liczby kart w oknie.
-
openerTabId
liczba opcjonalnie
Identyfikator karty, która otworzyła tę kartę. Jeśli została określona, karta otwierająca musi znajdować się w tym samym oknie co nowo utworzona karta.
-
przypięty
Wartość logiczna opcjonalna
Określa, czy karta ma zostać przypięta. Domyślna wartość to
false
-
wybrano
Wartość logiczna opcjonalna
WycofanoUżyj wartości aktywnej.
Określa, czy karta powinna stać się kartą wybraną w oknie. Domyślna wartość to
true
-
URL
ciąg znaków opcjonalny
Adres URL, pod który chcesz początkowo przejść na kartę. Pełne adresy URL muszą zawierać schemat (np. „http://www.google.com”, a nie „www.google.com”). Względne adresy URL odnoszą się do bieżącej strony w rozszerzeniu. Domyślnie jest to strona nowej karty.
-
windowId
liczba opcjonalnie
Okno, w którym ma zostać utworzona nowa karta. Wartość domyślna to bieżące okno.
-
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(tab: Tab) => void
-
tabulator
Utworzona karta.
-
Zwroty
-
Obietnica<Tab>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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 optional
Parametr
callback
wygląda tak:(language: string) => void
-
language
ciąg znaków
Kod języka ISO, np.
en
lubfr
. Pełną listę języków obsługiwanych przez tę metodę znajdziesz na stronie kLanguageInfoTable. Od 2 do 4 kolumny są sprawdzane, a zwracana jest pierwsza wartość niebędąca wartością NULL, z wyjątkiem języka chińskiego uproszczonego, dla którego zwracana jest wartośćzh-CN
. W przypadku nieznanego lub nieokreślonego języka zwracany jestund
.
-
Zwroty
-
Obietnica<ciąg>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
discard()
chrome.tabs.discard(
tabId?: number,
callback?: function,
)
Odrzuca kartę z pamięci. Odrzucone karty są nadal widoczne na pasku kart, a po aktywowaniu są ponownie wczytywane.
Parametry
-
tabId
liczba opcjonalnie
Identyfikator karty do odrzucenia. Jeśli karta jest określona, jest odrzucana, chyba że jest aktywna lub została odrzucona. Jeśli nazwa zostanie pominięta, przeglądarka odrzuci najmniej ważną kartę. Ten błąd może się nie powieść, jeśli nie ma żadnych kart do odrzucenia.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(tab?: Tab) => void
-
tabulator
Opcjonalne Tab
odrzucona karta, jeśli została odrzucona; w inny sposób.
-
Zwroty
-
Obietnica<Tab | niezdefiniowane>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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 duplikowania.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(tab?: Tab) => void
Zwroty
-
Obietnica<Tab | niezdefiniowane>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
executeScript()
chrome.tabs.executeScript(
tabId?: number,
details: InjectDetails,
callback?: function,
)
Zastąpiona wartością scripting.executeScript
na platformie Manifest V3.
Wstawia kod JavaScript na stronie. Szczegółowe informacje znajdziesz w sekcji dotyczącej wstrzykiwania automatycznego w dokumencie ze skryptami treści.
Parametry
-
tabId
liczba opcjonalnie
Identyfikator karty, na której ma zostać uruchomiony skrypt. domyślnie wyświetla się aktywna karta w bieżącym oknie.
-
szczegóły
Szczegóły skryptu do uruchomienia. Musisz ustawić kod lub właściwość pliku, ale nie możesz ustawić obu jednocześnie.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(result?: any[]) => void
-
wynik
any[] opcjonalne
Wynik skryptu w każdej wstrzykniętej klatce.
-
Zwroty
-
Promise<any[] | niezdefiniowane>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
get()
chrome.tabs.get(
tabId: number,
callback?: function,
)
Pobiera szczegółowe informacje o określonej karcie.
Parametry
-
tabId
liczba
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(tab: Tab) => void
-
tabulator
-
Zwroty
-
Obietnica<Tab>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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
Wartość domyślna to bieżące okno.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(tabs: Tab[]) => void
-
karty
Tab[]
-
Zwroty
-
Obietnica<Tab[]>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
getCurrent()
chrome.tabs.getCurrent(
callback?: function,
)
Pobiera kartę, z której pochodzi to wywołanie skryptu. Zwraca funkcję undefined
, jeśli została wywołana z kontekstu innego niż karta (np. strony w tle lub widoku wyskakującego).
Parametry
Zwroty
-
Obietnica<Tab | niezdefiniowane>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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
Wartość domyślna to bieżące okno.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(tab: Tab) => void
-
tabulator
-
Zwroty
-
Obietnica<Tab>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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 wyświetla się aktywna karta w bieżącym oknie.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(zoomFactor: number) => void
-
zoomFactor
liczba
Bieżący współczynnik powiększenia karty.
-
Zwroty
-
Promise<number>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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, z której pochodzą bieżące ustawienia powiększenia. domyślnie wyświetla się aktywna karta w bieżącym oknie.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(zoomSettings: ZoomSettings) => void
-
zoomSettings
Bieżące ustawienia powiększenia karty.
-
Zwroty
-
Promise<ZoomSettings>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
goBack()
chrome.tabs.goBack(
tabId?: number,
callback?: function,
)
Wróć na poprzednią stronę, jeśli jest dostępna.
Parametry
-
tabId
liczba opcjonalnie
Identyfikator karty, na którą chcesz wrócić. domyślnie wyświetla się karta wybrana w bieżącym oknie.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
Zwroty
-
Obietnica<void>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
goForward()
chrome.tabs.goForward(
tabId?: number,
callback?: function,
)
Przejdź do następnej strony, jeśli jest dostępna.
Parametry
-
tabId
liczba opcjonalnie
Identyfikator karty, od której można przejść dalej. domyślnie wyświetla się karta wybrana w bieżącym oknie.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
Zwroty
-
Obietnica<void>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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, a jeśli nie określono żadnej grupy, dodaje dane karty do nowo utworzonej grupy.
Parametry
-
Opcje
Obiekt
-
createProperties
obiekt opcjonalny
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 karty lub lista identyfikatorów kart, które chcesz dodać do określonej grupy.
-
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(groupId: number) => void
-
groupId
liczba
Identyfikator grupy, do której zostały dodane karty.
-
Zwroty
-
Promise<number>
Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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 koncentruje się na pierwszej z grup. Jeśli określona karta jest obecnie aktywna, nie będzie nic robić.
Parametry
-
highlightInfo
Obiekt
-
karty
liczba | liczba[]
Co najmniej jeden indeks kart do wyróżnienia.
-
windowId
liczba opcjonalnie
Okno zawierające karty.
-
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(window: Window) => void
-
okno
Zawiera szczegółowe informacje o oknie z podświetlonymi kartami.
-
Zwroty
-
Promise<windows.Window>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
insertCSS()
chrome.tabs.insertCSS(
tabId?: number,
details: InjectDetails,
callback?: function,
)
Zastąpiona wartością scripting.insertCSS
na platformie Manifest V3.
Wstawia kod CSS na stronie. Style wstawione przy użyciu tej metody można usunąć za pomocą narzędzia scripting.removeCSS
. Szczegółowe informacje znajdziesz w sekcji dotyczącej wstrzykiwania automatycznego w dokumencie ze skryptami treści.
Parametry
-
tabId
liczba opcjonalnie
Identyfikator karty, na której chcesz wstawić kod CSS; domyślnie wyświetla się aktywna karta w bieżącym oknie.
-
szczegóły
Szczegóły tekstu CSS do wstawienia. Musisz ustawić kod lub właściwość pliku, ale nie możesz ustawić obu jednocześnie.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
Zwroty
-
Obietnica<void>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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 na nowe miejsce w oknie lub do nowego okna. Pamiętaj, że karty można przenosić tylko do okien normalnych (window.type === „normalne”) i można z nich przenosić.
Parametry
-
tabIds
liczba | liczba[]
Identyfikator karty lub lista identyfikatorów kart do przeniesienia.
-
moveProperties
Obiekt
-
indeks
liczba
Położenie, do którego ma zostać przeniesione okno. Użyj klawisza
-1
, aby umieścić kartę na końcu okna. -
windowId
liczba opcjonalnie
Domyślnie jest to okno, w którym aktualnie jest otwarta karta.
-
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(tabs: Tab | Tab[]) => void
Zwroty
-
Chrome 88 i nowsze .
Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
query()
chrome.tabs.query(
queryInfo: object,
callback?: function,
)
Pobiera wszystkie karty o określonych właściwościach lub wszystkie karty, jeśli nie określono żadnych właściwości.
Parametry
-
queryInfo
Obiekt
-
aktywna
Wartość logiczna opcjonalna
Określa, czy karty w swoich oknach są aktywne.
-
audible
Wartość logiczna opcjonalna
Chrome w wersji 45 lub nowszej .Określa, czy karty mają włączony dźwięk.
-
autoDiscardable
Wartość logiczna opcjonalna
Chrome w wersji 54 lub nowszej .Określa, czy karty mogą być automatycznie odrzucane przez przeglądarkę przy niskim poziomie zasobów.
-
currentWindow
Wartość logiczna opcjonalna
Określa, czy karty znajdują się w bieżącym oknie.
-
odrzucono
Wartość logiczna opcjonalna
Chrome w wersji 54 lub nowszej .Określa, czy karty zostały odrzucone. Odrzucona karta to taka, której zawartość została wyładowana z pamięci, ale nadal widoczna na pasku kart. Zawartość zostanie wczytana ponownie, gdy następnym razem ją aktywujesz.
-
groupId
liczba opcjonalnie
Chrome 88 i nowsze .Identyfikator grupy, w której znajdują się karty, lub
tabGroups.TAB_GROUP_ID_NONE
w przypadku niezgrupowanych kart. -
wyróżniona
Wartość logiczna opcjonalna
Określa, czy karty są wyróżnione.
-
indeks
liczba opcjonalnie
Położenie kart w oknach.
-
lastFocusedWindow
Wartość logiczna opcjonalna
Określa, czy karty znajdują się w ostatnim aktywnym oknie.
-
Wyciszono
Wartość logiczna opcjonalna
Chrome w wersji 45 lub nowszej .Określa, czy karty mają być wyciszone.
-
przypięty
Wartość logiczna opcjonalna
Określa, czy karty są przypięte.
-
status
TabStatus (opcjonalny)
Stan wczytywania karty.
-
tytuł
ciąg znaków opcjonalny
Dopasuj tytuły stron do wzorca. Jeśli rozszerzenie nie ma uprawnienia
"tabs"
, ta właściwość jest ignorowana. -
URL
string | string[] opcjonalnie
Dopasuj karty do co najmniej jednego wzorca adresu URL. Identyfikatory fragmentów nie są dopasowane. Jeśli rozszerzenie nie ma uprawnienia
"tabs"
, ta właściwość jest ignorowana. -
windowId
liczba opcjonalnie
Identyfikator okna nadrzędnego lub
windows.WINDOW_ID_CURRENT
dla bieżącego okna. -
windowType
Opcjonalny WindowType
Typ okna, w którym znajdują się karty.
-
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(result: Tab[]) => void
-
wynik
Tab[]
-
Zwroty
-
Obietnica<Tab[]>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
reload()
chrome.tabs.reload(
tabId?: number,
reloadProperties?: object,
callback?: function,
)
Ponowne załadowanie karty.
Parametry
-
tabId
liczba opcjonalnie
identyfikator karty do ponownego załadowania; domyślnie wyświetla się karta wybrana w bieżącym oknie.
-
reloadProperties
obiekt opcjonalny
-
bypassCache
Wartość logiczna opcjonalna
Określa, czy pomijać lokalną pamięć podręczną. Domyślna wartość to
false
.
-
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
Zwroty
-
Obietnica<void>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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 karty lub lista identyfikatorów kart do zamknięcia.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
Zwroty
-
Obietnica<void>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
removeCSS()
chrome.tabs.removeCSS(
tabId?: number,
details: DeleteInjectionDetails,
callback?: function,
)
Zastąpiona wartością scripting.removeCSS
na platformie Manifest V3.
Usuwa z kodu CSS strony, który został wcześniej wstrzyknięty przez wywołanie scripting.insertCSS
.
Parametry
-
tabId
liczba opcjonalnie
Identyfikator karty, z której chcesz usunąć usługę porównywania cen. domyślnie wyświetla się aktywna karta w bieżącym oknie.
-
szczegóły
Szczegóły tekstu CSS do usunięcia. Musisz ustawić kod lub właściwość pliku, ale nie możesz ustawić obu jednocześnie.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
Zwroty
-
Obietnica<void>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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 uruchamianym po wysłaniu odpowiedzi. Zdarzenie runtime.onMessage
jest wywoływane w każdym skrypcie treści działającym na określonej karcie bieżącego rozszerzenia.
Parametry
-
tabId
liczba
-
wiadomość
każdy
Wiadomość do wysłania. Ta wiadomość powinna być obiektem obsługującym format JSON.
-
Opcje
obiekt opcjonalny
-
documentId
ciąg znaków opcjonalny
Chrome 106 lub nowszy .Wyślij wiadomość do konkretnego dokumentu określonego przez
documentId
zamiast wszystkich klatek na karcie. -
frameId
liczba opcjonalnie
Wyślij wiadomość do określonej ramki identyfikowanej przez tag
frameId
zamiast wszystkich klatek na karcie.
-
-
wywołanie zwrotne
funkcja optional
Chrome w wersji 99 lub nowszej .Parametr
callback
wygląda tak:(response: any) => void
-
odpowiedź
każdy
Obiekt odpowiedzi JSON wysłany przez moduł obsługi wiadomości. Jeśli podczas łączenia się z podaną kartą wystąpi błąd, wywołanie zwrotne jest wywoływane bez argumentów, a
runtime.lastError
zostaje ustawiony na komunikat o błędzie.
-
Zwroty
-
Obietnica<any>
Chrome w wersji 99 lub nowszej .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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 pojedyncze żądanie do skryptów treści na określonej karcie, z opcjonalnym wywołaniem zwrotnym uruchamianym po wysłaniu odpowiedzi. Zdarzenie extension.onRequest
jest wywoływane w każdym skrypcie treści działającym na określonej karcie bieżącego rozszerzenia.
Parametry
-
tabId
liczba
-
żądanie
każdy
-
wywołanie zwrotne
funkcja optional
Chrome w wersji 99 lub nowszej .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 się z podaną kartą wystąpi błąd, wywołanie zwrotne jest wywoływane bez argumentów, a
runtime.lastError
zostaje ustawiony na komunikat o błędzie.
-
Zwroty
-
Obietnica<any>
Chrome w wersji 99 lub nowszej .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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 do powiększenia; domyślnie wyświetla się aktywna karta w bieżącym oknie.
-
zoomFactor
liczba
Nowy współczynnik powiększenia. Wartość
0
ustawia bieżący domyślny współczynnik powiększenia karty. Wartości większe niż0
określają (prawdopodobnie inny) współczynnik powiększenia karty. -
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
Zwroty
-
Obietnica<void>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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. Po przejściu na tę kartę ustawienia te są resetowane do wartości domyślnych.
Parametry
-
tabId
liczba opcjonalnie
Identyfikator karty, dla której chcesz zmienić ustawienia powiększenia. domyślnie wyświetla się aktywna karta w bieżącym oknie.
-
zoomSettings
Określa sposób obsługi zmian powiększenia i zakres.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
Zwroty
-
Obietnica<void>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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 odpowiednich grup. Jeśli któraś z grup stanie się pusta, zostaną usunięte.
Parametry
-
tabIds
liczba | [liczba, ...liczba[]]
Identyfikator karty lub lista identyfikatorów kart do usunięcia z odpowiednich grup.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
Zwroty
-
Obietnica<void>
Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane 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 funkcji updateProperties
, nie są modyfikowane.
Parametry
-
tabId
liczba opcjonalnie
Domyślnie wyświetlana jest karta wybrana w bieżącym oknie.
-
updateProperties
Obiekt
-
aktywna
Wartość logiczna opcjonalna
Określa, czy karta ma być aktywna. Nie ma wpływu na to, czy okno ma być aktywne (patrz
windows.update
). -
autoDiscardable
Wartość logiczna opcjonalna
Chrome w wersji 54 lub nowszej .Określa, czy karta ma być automatycznie odrzucana przez przeglądarkę przy niskim poziomie zasobów.
-
wyróżniona
Wartość logiczna opcjonalna
Powoduje dodanie lub usunięcie aktualnie zaznaczonej karty.
-
Wyciszono
Wartość logiczna opcjonalna
Chrome w wersji 45 lub nowszej .Określa, czy karta ma być wyciszona.
-
openerTabId
liczba opcjonalnie
Identyfikator karty, która otworzyła tę kartę. 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 zostać przypięta.
-
wybrano
Wartość logiczna opcjonalna
WycofanoUżyj opcji wyróżnionych.
Określa, czy należy wybrać kartę.
-
URL
ciąg znaków opcjonalny
Adres URL umożliwiający przejście na kartę. Adresy URL JavaScript nie są obsługiwane. użyj
scripting.executeScript
.
-
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(tab?: Tab) => void
Zwroty
-
Obietnica<Tab | niezdefiniowane>
Chrome 88 i nowsze .Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.
Wydarzenia
onActivated
chrome.tabs.onActivated.addListener(
callback: function,
)
Uruchamiany, gdy zmieni się aktywna karta w oknie. Pamiętaj, że URL karty może nie być ustawiony w chwili wywołania tego zdarzenia, ale możesz nasłuchiwać zdarzeń onUpdated, by otrzymać powiadomienie o ustawieniu adresu URL.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(activeInfo: object) => void
-
activeInfo
Obiekt
-
tabId
liczba
Identyfikator karty, która została aktywowana.
-
windowId
liczba
Identyfikator okna, w którym zmieniła się aktywna karta.
-
-
onActiveChanged
chrome.tabs.onActiveChanged.addListener(
callback: function,
)
Użyj adresu tabs.onActivated
.
Uruchamiany po zmianie wybranej karty w oknie. Pamiętaj, że URL karty może nie być ustawiony w chwili wywołania tego zdarzenia, ale możesz nasłuchiwać zdarzeń tabs.onUpdated
, aby otrzymać powiadomienie o ustawieniu adresu URL.
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 została zmieniona wybrana karta.
-
-
onAttached
chrome.tabs.onAttached.addListener(
callback: function,
)
Uruchamiane, gdy do okna dołączona jest karta. bo przenieśliśmy je 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 w momencie wywołania tego zdarzenia nie możesz określić adresu URL i przynależności do grupy kart, ale możesz nasłuchiwać zdarzeń onUpdated, aby otrzymywać powiadomienia o ustawieniu adresu URL lub dodaniu karty do grupy kart.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(tab: Tab) => void
-
tabulator
-
onDetached
chrome.tabs.onDetached.addListener(
callback: function,
)
Uruchamiane po odłączeniu karty od okna. bo przenieśliśmy je 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 podświetlonych lub wybranych kart w oknie.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(selectInfo: object) => void
-
selectInfo
Obiekt
-
tabIds
liczba[]
Wszystkie podświetlone karty w oknie.
-
windowId
liczba
Okno, w którym zostały zmienione karty.
-
-
onHighlighted
chrome.tabs.onHighlighted.addListener(
callback: function,
)
Uruchamiane po zmianie podświetlonych lub wybranych kart w oknie.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(highlightInfo: object) => void
-
highlightInfo
Obiekt
-
tabIds
liczba[]
Wszystkie podświetlone karty w oknie.
-
windowId
liczba
Okno, w którym zostały zmienione karty.
-
-
onMoved
chrome.tabs.onMoved.addListener(
callback: function,
)
Uruchamiane po przeniesieniu karty 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ą przesunąć się w odpowiedzi na ręcznie przeniesioną kartę. To zdarzenie nie jest wywoływane, gdy karta przesuwa się między oknami. Więcej informacji: 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 po zamknięciu karty.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(tabId: number, removeInfo: object) => void
-
tabId
liczba
-
removeInfo
Obiekt
-
isWindowClosing
wartość logiczna
Prawda, gdy karta została zamknięta, ponieważ jej okno nadrzędne zostało zamknięte.
-
windowId
liczba
Okno, którego karta jest zamknięta.
-
-
onReplaced
chrome.tabs.onReplaced.addListener(
callback: function,
)
Uruchamiane, gdy karta zostanie zastąpiona inną kartą z powodu renderowania wstępnego lub dynamicznego.
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 wybranej 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 została zmieniona 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 w wersji 45 lub nowszej .Nowy stan karty z włączonym dźwiękiem.
-
autoDiscardable
Wartość logiczna opcjonalna
Chrome w wersji 54 lub nowszej .Nowy stan karty, który można automatycznie odrzucać.
-
odrzucono
Wartość logiczna opcjonalna
Chrome w wersji 54 lub nowszej .Nowy stan karty.
-
favIconUrl
ciąg znaków opcjonalny
Adres URL nowej favikony karty.
-
groupId
liczba opcjonalnie
Chrome 88 i nowsze .Nowa grupa karty.
-
mutedInfo
MutedInfo opcjonalne
Chrome w wersji 46 lub nowszej, .Nowy stan wyciszenia karty i przyczyny zmiany.
-
przypięty
Wartość logiczna opcjonalna
Karta jako nowa przypięta.
-
status
TabStatus (opcjonalny)
Stan wczytywania karty.
-
tytuł
ciąg znaków opcjonalny
Chrome w wersji 48 lub nowszej, .Nowy tytuł karty.
-
URL
ciąg znaków opcjonalny
Adres URL karty, jeśli uległ zmianie.
-
-
tabulator
-
onZoomChange
chrome.tabs.onZoomChange.addListener(
callback: function,
)
Uruchamiane przy powiększeniu karty.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(ZoomChangeInfo: object) => void
-
ZoomChangeInfo
Obiekt
-
newZoomFactor
liczba
-
oldZoomFactor
liczba
-
tabId
liczba
-
zoomSettings
-
-