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.

Omówienie

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

Użycie 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.
Uprawnienia hosta
Uprawnienia hosta umożliwiają rozszerzeniu odczytywanie 4 poufnych danych karty i wykonywanie dotyczących jej zapytań tabs.Tab usług. 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().
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ń.

Plik manifestu

Oto przykłady zadeklarowania poszczególnych uprawnień w pliku manifestu:

  {
    "name": "My extension",
    ...
    "permissions": [
      "tabs"
    ],
    ...
  }

  {
    "name": "My extension",
    ...
    "host_permissions": [
      "http://*/*",
      "https://*/*"
    ],
    ...
  }

  {
    "name": "My extension",
    ...
    "permissions": [
      "activeTab"
    ],
    ...
  }

Przypadki użycia

W sekcjach poniżej przedstawiliśmy niektóre typowe przypadki użycia.

Otwieram 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

    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

    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

    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

    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ść

2

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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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

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 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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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

      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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

executeScript()

Obietnica &amp;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

    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&lt;any[] | niezdefiniowane>

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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

Zwroty

  • Obietnica<Tab>

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getAllInWindow()

Obietnica &amp;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

Zwroty

  • Obietnica<Tab[]>

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getSelected()

Obietnica &amp;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

Zwroty

  • Obietnica<Tab>

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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&lt;number&gt;

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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

      Bieżące ustawienia powiększenia karty.

Zwroty

  • Promise&lt;ZoomSettings&gt;

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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&lt;number&gt;

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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

      Zawiera szczegółowe informacje o oknie z podświetlonymi kartami.

Zwroty

  • Promise&lt;windows.Window&gt;

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

insertCSS()

Obietnica &amp;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

    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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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

Zwroty

  • Obietnica<Tab[]>

    Chrome 88 i nowsze .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

reload()

Obietnica .
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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

removeCSS()

Obietnica Chrome w wersji 87 lub nowszej &amp;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 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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

sendRequest()

Obietnica &amp;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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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

    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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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 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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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 tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

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

&amp;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

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

&amp;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

&amp;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

        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