Ta strona została przetłumaczona przez Cloud Translation API.

chrome.tabs

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 funkcji tabs.query() do czterech właściwości o charakterze kontrowersyjnym w instancjach tabs.Tab: url, pendingUrl, title i favIconUrl.

{
  "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 jako tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() i tabs.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ń hosta activeTab 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

Chrome w wersji 46 lub nowszej, .

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

Chrome w wersji 46 lub nowszej, .

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ć na chrome.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

Opcjonalne MutedInfo

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

Wycofano

Uż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

Chrome w wersji 44 lub nowszej .

Stan wczytywania karty.

Typ wyliczeniowy

"unload"

"loading"

"complete"

WindowType

Chrome w wersji 44 lub nowszej .

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 trybie automatic. W przeciwnym razie ma wartość per-tab.

ZoomSettingsMode

Chrome w wersji 44 lub nowszej .

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

Chrome w wersji 44 lub nowszej .

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

Chrome w wersji 92 lub nowszej .

Maksymalna liczba wywołań funkcji captureVisibleTab na sekundę. Usługa captureVisibleTab jest droga i nie należy jej wywoływać zbyt często.

Wartość

TAB_ID_NONE

Chrome w wersji 46 lub nowszej, .

Identyfikator, który odnosi się do braku karty przeglądarki.

Wartość

–1

TAB_INDEX_NONE

Chrome w wersji 123 lub nowszej .

Indeks reprezentujący brak indeksu kart w pasku tab_strip.

Wartość

–1

Metody

captureVisibleTab()

Obietnica .

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 promowane 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

runtime.Port

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()

Obietnica .

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ść to true.
- 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
  
  Wycofano
  
  Uż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 wyświetla się 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
  
  Karta
  
  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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

detectLanguage()

Obietnica .

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 lub fr. 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 jest und.

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

discard()

Obietnica Chrome w wersji 54 lub nowszej

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
  
  Tab opcjonalnie
  
  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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

duplicate()

Obietnica .

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
```
.
- tabulator
  
  Opcjonalne Tab
  
  Szczegółowe informacje o zduplikowanej karcie. Obiekt tabs.Tab nie zawiera url, pendingUrl, title ani favIconUrl, jeśli nie zażądano uprawnienia "tabs".

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

executeScript()

Obietnica &leq; MV2 Wycofane od Chrome 91

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

InjectDetails

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

get()

Obietnica .

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
  
  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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

getAllInWindow()

Obietnica &leq; MV2 Wycofano

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

getCurrent()

Obietnica .

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

wywołanie zwrotne

funkcja optional

Parametr callback wygląda tak:
```
(tab?: Tab) => void
```
.
- tabulator
  
  Opcjonalne Tab

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

getSelected()

Obietnica &leq; MV2 Wycofano

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
  
  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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

getZoom()

Obietnica .

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

getZoomSettings()

Obietnica .

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
  
  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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

goBack()

Obietnica Chrome w wersji 72 lub nowszej

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

goForward()

Obietnica Chrome w wersji 72 lub nowszej

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

group()

Obietnica Chrome w wersji 88 lub nowszej

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

highlight()

Obietnica .

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
  
  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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

insertCSS()

Obietnica &leq; MV2 Wycofane od Chrome 91

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

InjectDetails

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

move()

Obietnica .

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
```
.
- karty
  
  Tab | Karta[]
  
  Szczegółowe informacje o przeniesionych kartach.

Zwroty

Obietnica<Tab | 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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

query()

Obietnica .

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

reload()

Obietnica .

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
)

Załaduj ponownie kartę.

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

remove()

Obietnica .

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

removeCSS()

Obietnica Chrome w wersji 87 lub nowszej &leq; MV2 Wycofane od Chrome 91

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

DeleteInjectionDetails

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

sendMessage()

Obietnica .

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

sendRequest()

Obietnica &leq; MV2 Wycofano

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setZoom()

Obietnica .

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setZoomSettings()

Obietnica .

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

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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

ungroup()

Obietnica Chrome w wersji 88 lub nowszej

chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
)

Usuwa co najmniej 1 kartę z odpowiednich grup. Jeśli jakieś grupy staną się puste, 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 promowane jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

update()

Obietnica .

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
  
  Wycofano
  
  Uż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
```
.
- tabulator
  
  Opcjonalne Tab
  
  Szczegółowe informacje na temat zaktualizowanej karty. Obiekt tabs.Tab nie zawiera url, pendingUrl, title ani favIconUrl, jeśli nie zażądano uprawnienia "tabs".

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 promowane 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

&leq; MV2 Wycofano

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
  
  Karta

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

&leq; MV2 Wycofano

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

&leq; MV2 Wycofano

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
    
    Opcjonalne MutedInfo
    
    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
  
  Karta

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
    
    ZoomSettings