chrome.tabs

Opis

Użyj interfejsu API chrome.tabs, aby wchodzić w interakcje z systemem kart przeglądarki. Za pomocą tego interfejsu API możesz tworzyć, modyfikować i przestawiać karty w przeglądarce.

Interfejs Tabs API udostępnia nie tylko funkcje manipulowania kartami i zarządzania nimi, ale też umożliwia wykrywanie języka karty, robienie zrzutów ekranu oraz komunikowanie się ze skryptami treści karty.

Uprawnienia

Większość funkcji nie wymaga żadnych uprawnień. Na przykład: tworzenie nowej karty, przeładowywanie karty, przechodzenie do innego adresu URL itp.

Podczas pracy z interfejsem Tabs API programiści powinni zwracać uwagę na 3 rodzaje uprawnień.

Uprawnienie „karty”

To uprawnienie nie zapewnia dostępu do przestrzeni nazw chrome.tabs. Zamiast tego rozszerzeniu przyznaje możliwość wywoływania funkcji tabs.query() w przypadku 4 wrażliwych właściwości w przypadku tabs.Tab: url, pendingUrl, title i favIconUrl.

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

Uprawnienia hosta umożliwiają rozszerzeniu odczytywanie i wysyłanie zapytań dotyczących 4 wrażliwych właściwości tabs.Tab na pasku dopasowania. Mogą też bezpośrednio wchodzić w interakcje z odpowiednimi kartami za pomocą takich metod jak tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() i tabs.removeCSS().

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

activeTab w odpowiedzi na wywołanie przez użytkownika przyznaje rozszerzeniu tymczasowe uprawnienia hosta dla bieżącej karty. W przeciwieństwie do uprawnień hosta activeTab nie powoduje żadnych ostrzeżeń.

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

Przypadki użycia

W następnych sekcjach przedstawiamy kilka typowych zastosowań.

Otwieranie strony rozszerzenia w nowej karcie

Rozszerzenia często otwierają stronę wprowadzającą w nowej karcie po zainstalowaniu rozszerzenia. Poniżej znajdziesz przykład, jak to zrobić.

background.js:

chrome.runtime.onInstalled.addListener(({reason}) => {
  if (reason === 'install') {
    chrome.tabs.create({
      url: "onboarding.html"
    });
  }
});

Pobieranie bieżącej karty

Ten przykład pokazuje, jak usługa robocza rozszerzenia może pobrać aktywną kartę z okna, które jest aktualnie w centrum uwagi (lub z ostatnio aktywnego okna, jeśli żadne okna Chrome nie są aktywne). Zazwyczaj można to traktować jako bieżącą kartę użytkownika.

  async function getCurrentTab() {
    let queryOptions = { active: true, lastFocusedWindow: true };
    // `tab` will either be a `tabs.Tab` instance or `undefined`.
    let [tab] = await chrome.tabs.query(queryOptions);
    return tab;
  }


  function getCurrentTab(callback) {
    let queryOptions = { active: true, lastFocusedWindow: true };
    chrome.tabs.query(queryOptions, ([tab]) => {
      if (chrome.runtime.lastError)
      console.error(chrome.runtime.lastError);
      // `tab` will either be a `tabs.Tab` instance or `undefined`.
      callback(tab);
    });
  }

Wycisz określoną kartę

Ten przykład pokazuje, jak rozszerzenie może włączać i wyłączać wyciszenie danej karty.

  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" }`);
    });
  }

Przenoszenie bieżącej karty na pierwszą pozycję po kliknięciu

Ten przykład pokazuje, jak przenosić kartę, gdy przeciąganie może być w toku lub nie. W tym przykładzie użyto funkcji chrome.tabs.move, ale możesz użyć tego samego wzorca oczekiwania w przypadku innych wywołań, które modyfikują karty podczas przeciągania.

  chrome.tabs.onActivated.addListener(moveToFirstPosition);

  async function moveToFirstPosition(activeInfo) {
    try {
      await chrome.tabs.move(activeInfo.tabId, {index: 0});
      console.log("Success.");
    } catch (error) {
      if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
        setTimeout(() => moveToFirstPosition(activeInfo), 50);
      } else {
        console.error(error);
      }
    }
  }


  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);

  function moveToFirstPositionMV2(activeInfo) {
    chrome.tabs.move(activeInfo.tabId, { index: 0 }, () => {
      if (chrome.runtime.lastError) {
        const error = chrome.runtime.lastError;
        if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
          setTimeout(() => moveToFirstPositionMV2(activeInfo), 50);
        } else {
          console.error(error);
        }
      } else {
        console.log("Success.");
      }
    });
  }

Przekazywanie wiadomości do skryptu treści wybranej karty

Ten przykład pokazuje, jak serwis worker rozszerzenia może komunikować się z skryptami treści na określonych kartach przeglądarki za pomocą tabs.sendMessage().

function sendMessageToActiveTab(message) {
  const [tab] = await chrome.tabs.query({ active: true, lastFocusedWindow: true });
  const response = await chrome.tabs.sendMessage(tab.id, message);
  // TODO: Do something with the response.
}

Przykłady rozszerzeń

Aby zobaczyć więcej demonstracji rozszerzeń interfejsu Tabs API, zapoznaj się z tymi materiałami:

Typy

MutedInfo

Chrome 46 lub nowszy

Stan wyciszenia karty i przyczyna ostatniej zmiany stanu.

Właściwości

  • extensionId

    ciąg znaków opcjonalny

    Identyfikator rozszerzenia, które zmieniło stan wyciszenia. Nie ustawione, jeśli rozszerzenie nie było przyczyną ostatniej zmiany stanu wyciszenia.

  • Wyciszono

    wartość logiczna

    Czy karta jest wyciszona (czy nie odtwarza dźwięku). Karta może być wyciszona, nawet jeśli nie została jeszcze odtworzona lub nie jest obecnie odtwarzana. To samo, co wyświetlanie wskaźnika wyciszenia dźwięku.

  • reason

    MutedInfoReason opcjonalnie

    powód wyciszenia lub odwrócenia wyciszenia karty. Nie ustawione, jeśli stan wyciszenia karty nigdy nie został zmieniony.

MutedInfoReason

Chrome 46 lub nowszy

Zdarzenie, które spowodowało zmianę stanu wyciszenia.

Typ wyliczeniowy

"user"
Działanie użytkownika, które ustawia stan wyciszenia.

„capture”
Rozpoczęto przechwytywanie karty, co powoduje wymuszenie zmiany stanu wyciszenia.

"extension"
Rozszerzenie z identyfikatorem extensionId, które jest wyciszone.

Tab

Właściwości

  • aktywna

    wartość logiczna

    Określa, czy karta jest aktywna w oknie. Nie oznacza to, że okno jest aktywne.

  • audible

    logiczna opcjonalna

    Chrome 45 i nowsze

    czy karta wygenerowała dźwięk w ciągu ostatnich kilku sekund (może on być niesłyszalny, jeśli karta jest wyciszona). To samo, co wyświetlanie wskaźnika „Dźwięk głośnika”.

  • autoDiscardable

    wartość logiczna

    Chrome 54 lub nowszy

    Określa, czy karta może być automatycznie odrzucona przez przeglądarkę, gdy zasoby są niskie.

  • odrzucono

    wartość logiczna

    Chrome 54 lub nowszy

    Określa, czy karta została odrzucona. Odrzucona karta to karta, której zawartość została wyjęta z pamięci, ale nadal jest widoczna na pasku kart. Treści są ponownie wczytywane przy następnym włączeniu.

  • favIconUrl

    ciąg znaków opcjonalny

    Adres URL favikony karty. Ta właściwość jest obecna tylko wtedy, gdy plik manifestu rozszerzenia zawiera uprawnienia "tabs". Może to być też pusty ciąg znaków, jeśli karta jest wczytywana.

  • zamrożony

    wartość logiczna

    Oczekuje

    Czy karta jest zablokowana. Zablokowana karta nie może wykonywać zadań, w tym modułów obsługi zdarzeń ani zegarów. Jest widoczna na pasku kart, a jej zawartość jest wczytana do pamięci. Po aktywacji jest odblokowany.

  • groupId

    liczba

    Chrome 88 lub nowszy

    Identyfikator grupy, do której należy karta.

  • wysokość

    number opcjonalny

    Wysokość karty w pikselach.

  • wyróżniona

    wartość logiczna

    Czy karta jest wyróżniona.

  • id

    number opcjonalny

    Identyfikator karty. Identyfikatory kart są unikalne w ramach sesji przeglądarki. W niektórych okolicznościach do karty nie można przypisać identyfikatora. Może się tak zdarzyć na przykład podczas wysyłania zapytań do obcych kart za pomocą interfejsu sessions API. W takim przypadku może być obecny identyfikator sesji. Identyfikator karty może też mieć wartość chrome.tabs.TAB_ID_NONE w przypadku okien aplikacji i narzędzi deweloperskich.

  • incognito

    wartość logiczna

    Określa, czy karta znajduje się w oknie incognito.

  • indeks

    liczba

    Indeks karty w oknie, liczony od zera.

  • lastAccessed

    liczba

    Chrome 121 lub nowszy

    Ostatni czas uzyskania dostępu do karty podany jako liczba milisekund od początku epoki.

  • mutedInfo

    MutedInfo opcjonalnie

    Chrome 46 lub nowszy

    Stan wyciszenia karty i przyczyna ostatniej zmiany stanu.

  • openerTabId

    number opcjonalny

    Identyfikator karty, która otworzyła tę kartę (jeśli istnieje). Ta właściwość jest obecna tylko wtedy, gdy karta otwierająca nadal istnieje.

  • pendingUrl

    ciąg znaków opcjonalny

    Chrome 79 lub nowszy

    Adres URL, do którego przekierowuje karta, zanim nastąpi zmiana. Ta właściwość jest obecna tylko wtedy, gdy plik manifestu rozszerzenia zawiera uprawnienie "tabs" i wystąpiła oczekująca nawigacja.

  • przypięty

    wartość logiczna

    Czy karta jest przypięta.

  • wybrano

    wartość logiczna

    Wycofane

    Użyj wartości tabs.Tab.highlighted.

    Informacja o tym, czy karta jest wybrana.

  • sessionId

    ciąg znaków opcjonalny

    Identyfikator sesji służący do jednoznacznej identyfikacji karty uzyskanej z interfejsu API sessions.

  • status

    TabStatus opcjonalnie

    Stan wczytywania karty.

  • tytuł

    ciąg znaków opcjonalny

    Tytuł karty. Ta właściwość jest obecna tylko wtedy, gdy plik manifestu rozszerzenia zawiera uprawnienia "tabs".

  • URL

    ciąg znaków opcjonalny

    Ostatni zaakceptowany adres URL głównej ramki karty. Ta właściwość jest obecna tylko wtedy, gdy plik manifestu rozszerzenia zawiera uprawnienia "tabs". Może być pustym ciągiem znaków, jeśli karta nie została jeszcze zaakceptowana. Zobacz też Tab.pendingUrl.

  • szerokość

    number opcjonalny

    Szerokość karty w pikselach.

  • windowId

    liczba

    Identyfikator okna zawierającego kartę.

TabStatus

Chrome 44 lub nowszy

Stan wczytywania karty.

Typ wyliczeniowy

„unloaded”

„loading”

„complete”

WindowType

Chrome 44 lub nowszy

Typ okna.

Typ wyliczeniowy

„normal”

„popup”

„panel”

"app"

„devtools”

ZoomSettings

Określa, jak i w jakim zakresie są obsługiwane zmiany powiększenia na karcie.

Właściwości

  • defaultZoomFactor

    number opcjonalny

    Chrome 43 lub nowszy

    Służy do zwracania domyślnego poziomu powiększenia bieżącej karty w wywołaniach funkcji tabs.getZoomSettings.

  • tryb

    ZoomSettingsMode opcjonalnie

    Określa sposób obsługi zmian powiększenia, czyli określa, która strona jest odpowiedzialna za rzeczywiste skalowanie strony. Wartość domyślna to automatic.

  • zakres

    ZoomSettingsScope opcjonalnie

    Określa, czy zmiany powiększenia są zachowywane w źródle strony czy mają zastosowanie tylko na tej karcie. Domyślnie ustawione jest per-origin w trybie automatic, a w innym przypadku per-tab.

ZoomSettingsMode

Chrome 44 lub nowszy

Określa sposób obsługi zmian powiększenia, czyli określa, która strona jest odpowiedzialna za rzeczywiste skalowanie strony. Wartość domyślna to automatic.

Typ wyliczeniowy

„automatycznie”
Zmiany powiększenia są obsługiwane automatycznie przez przeglądarkę.

„manual”
Przesłonięć automatyczne zmiany powiększenia. Zdarzenie onZoomChange nadal będzie wysyłane, a rozszerzenie musi na nie reagować i ręcznie skalować stronę. Ten tryb nie obsługuje powiększania per-origin, więc ignoruje ustawienie powiększenia scope i zakłada per-tab.

„disabled” (wyłączone)
Wyłącza wszystkie opcje powiększania na karcie. Karta wraca do domyślnego poziomu powiększenia, a wszystkie próby zmiany powiększenia są ignorowane.

ZoomSettingsScope

Chrome 44 lub nowszy

Określa, czy zmiany powiększenia są zachowywane w źródle strony czy mają zastosowanie tylko na tej karcie. Domyślnie ustawione jest per-origin w trybie automatic, a w innym przypadku per-tab.

Typ wyliczeniowy

„Per-origin”
Zmiany powiększenia są zachowywane w źródle powiększonej strony, co oznacza, że wszystkie inne karty, które otwierają tę samą stronę, są również powiększone. Ponadto zmiany powiększenia per-origin są zapisywane w źródle, co oznacza, że podczas przechodzenia na inne strony w tym samym źródle wszystkie są powiększone o ten sam współczynnik. Zakres per-origin jest dostępny tylko w trybie automatic.

„Na karcie”
Zmiany powiększenia mają zastosowanie tylko na tej karcie, a zmiany powiększenia na innych kartach nie wpływają na powiększenie tej karty. Ponadto podczas nawigacji resetowane są zmiany powiększenia per-tab; podczas nawigacji na karcie zawsze wczytywane są strony z odpowiednimi współczynnikami powiększenia per-origin.

Właściwości

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 lub nowszy

Maksymalna liczba wywołań funkcji captureVisibleTab na sekundę. captureVisibleTab jest drogi i nie należy go wywoływać zbyt często.

Wartość

2

TAB_ID_NONE

Chrome 46 lub nowszy

Identyfikator, który reprezentuje brak karty przeglądarki.

Wartość

-1

TAB_INDEX_NONE

Chrome 123+

Indeks, który reprezentuje brak indeksu karty w elemencie tab_strip.

Wartość

-1

Metody

captureVisibleTab()

Obietnice 
chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
)

Wykonuje zrzut ekranu widocznego obszaru na aktywnej karcie w określonym oknie. Aby wywołać tę metodę, rozszerzenie musi mieć uprawnienia <all_urls> lub activeTab. Oprócz stron, do których rozszerzenia mają normalny dostęp, ta metoda pozwala im przechwytywać strony zawierające dane wrażliwe, które są w innym przypadku ograniczone, w tym strony z adresami chrome:, inne strony rozszerzeń i adresy URL z dane:. Te strony zawierające dane wrażliwe można przechwytywać tylko za pomocą uprawnienia activeTab. Adresy URL plików mogą być przechwytywane tylko wtedy, gdy rozszerzeniu przyznano dostęp do plików.

Parametry

  • windowId

    number opcjonalny

    Okno docelowe. Domyślnie jest to bieżące okno.

  • Opcje

    ImageDetails opcjonalny

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (dataUrl: string) => void

    • dataUrl

      ciąg znaków

      Adres URL danych, który koduje obraz widocznego obszaru przechwyconej karty. Może być przypisany do właściwości „src” elementu HTML img w celu wyświetlenia.

Zwroty

  • Promise<string>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

connect()

chrome.tabs.connect(
  tabId: number,
  connectInfo?: object,
)

Połącza się ze skryptami treści na określonej karcie. Zdarzenie runtime.onConnect jest wywoływane w każdym skrypcie treści uruchomionym na określonej karcie w bieżącym rozszerzeniu. Więcej informacji znajdziesz w artykule Komunikowanie się za pomocą skryptu treści.

Parametry

  • tabId

    liczba

  • connectInfo

    object opcjonalne

    • documentId

      ciąg znaków opcjonalny

      Chrome 106 lub nowszy

      Otwórz port dla określonego dokumentu oznaczonego documentId, a nie wszystkich ramek na karcie.

    • frameId

      number opcjonalny

      Otwórz port dla określonego ujęcia oznaczonego przez frameId, a nie dla wszystkich ujęć na karcie.

    • nazwa

      ciąg znaków opcjonalny

      Jest przekazywany do metody 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 działającymi na określonej karcie. Zdarzenie runtime.Port portu jest wywoływane, gdy karta jest zamknięta lub nie istnieje.

create()

Obietnice 
chrome.tabs.create(
  createProperties: object,
  callback?: function,
)

Tworzy nową kartę.

Parametry

  • createProperties

    Obiekt

    • aktywna

      logiczna opcjonalna

      Określa, czy karta ma stać się aktywną kartą w oknie. Nie ma wpływu na to, czy okno jest aktywne (patrz windows.update). Domyślnie ustawiona wartość to true.

    • indeks

      number opcjonalny

      Położenie karty w oknie. Podana wartość jest ograniczona do zakresu od 0 do liczby kart w oknie.

    • openerTabId

      number opcjonalny

      Identyfikator karty, która otworzyła tę kartę. Jeśli jest określona, karta otwierająca musi być w tym samym oknie co nowo utworzona karta.

    • przypięty

      logiczna opcjonalna

      Określa, czy karta ma być przypięta. Domyślna wartość to false

    • wybrano

      logiczna opcjonalna

      Wycofane

      Użyj słowa active (aktywny).

      Określa, czy karta ma być wybrana w oknie. Domyślna wartość to true

    • URL

      ciąg znaków opcjonalny

      Adres URL, do którego ma przejść karta. 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 Nowa karta.

    • windowId

      number opcjonalny

      Okno, w którym można utworzyć nową kartę. Domyślnie jest to bieżące okno.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (tab: Tab) => void

Zwroty

  • Obietnica<karta>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

detectLanguage()

Obietnice 
chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
)

Wykrywanie głównego języka treści na karcie.

Parametry

  • tabId

    number opcjonalny

    Domyślnie jest to aktywna karta w bieżącym oknie.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (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 w stałym polu kLanguageInfoTable. Sprawdzane są kolumny od 2. do 4. i zwracana jest pierwsza niepusta wartość, z wyjątkiem języka uproszczonego chińskiego, dla którego zwracana jest wartość zh-CN. W przypadku nieznanego lub nieokreślonego języka zwracana jest wartość und.

Zwroty

  • Promise<string>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

discard()

Obietnice Chrome 54 lub nowszy 
chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)

Odrzuca kartę z pamięci. Odrzucone karty są nadal widoczne na pasku kart i ładują się ponownie po ich aktywacji.

Parametry

  • tabId

    number opcjonalny

    Identyfikator karty, która ma zostać odrzucona. Jeśli jest określona, karta jest odrzucana, chyba że jest aktywna lub została już odrzucona. Jeśli nie zostanie podany, przeglądarka odrzuci najmniej ważną kartę. Może się to nie udać, jeśli nie ma kart, które można odrzucić.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (tab?: Tab) => void

    • tabulator

      Tabulator opcjonalny

      Karta odrzucona, jeśli została odrzucona. W przeciwnym razie nieokreślona.

Zwroty

  • Obietkwarzeczenie<Tab | nieokreślony>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

duplicate()

Obietnice 
chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
)

Duplikuje kartę.

Parametry

  • tabId

    liczba

    Identyfikator karty, którą chcesz zduplikować.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (tab?: Tab) => void

    • tabulator

      Tabulator opcjonalny

      Szczegóły dotyczące zduplikowanej karty. Obiekt tabs.Tab nie zawiera elementów url, pendingUrl, title i favIconUrl, jeśli nie określono uprawnienia "tabs".

Zwroty

  • Obietkwarzeczenie<Tab | nieokreślony>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

executeScript()

Obietki typu Promise &leq; MV2 Wycofane w Chrome 91
chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Zastąpione przez scripting.executeScript w pliku manifestu V3.

Wstrzykuje kod JavaScript na stronie. Szczegółowe informacje znajdziesz w sekcji wstawiania programowego w dokumencie dotyczącym skryptów treści.

Parametry

  • tabId

    number opcjonalny

    Identyfikator karty, na której ma być uruchomiony skrypt; domyślnie jest to aktywna karta bieżącego okna.

  • szczegóły

    InjectDetails

    Szczegóły skryptu do wykonania. Musisz ustawić kod lub plik, ale nie możesz ustawić obu naraz.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result?: any[]) => void

    • wynik

      any[] opcjonalny

      Wynik skryptu w każdej wstrzykniętej klatce.

Zwroty

  • Obietkw<dowolna tablica | niezdefiniowana>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

get()

Obietnice 
chrome.tabs.get(
  tabId: number,
  callback?: function,
)

Pobiera szczegóły określonej karty.

Parametry

  • tabId

    liczba

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (tab: Tab) => void

Zwroty

  • Obietnica<karta>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

getAllInWindow()

Obietnice &leq; MV2 Wycofane
chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)

Użyj tabs.query {windowId: windowId}.

Pobiera szczegóły wszystkich kart w określonym oknie.

Parametry

  • windowId

    number opcjonalny

    Domyślnie jest to bieżące okno.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (tabs: Tab[]) => void

Zwroty

  • Obietnice<Tab[]>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

getCurrent()

Obietnice 
chrome.tabs.getCurrent(
  callback?: function,
)

Pobiera kartę, z której pochodzi wywołanie skryptu. Zwraca undefined, jeśli jest wywoływany z kontekstu innego niż karta (np. strona w tle lub okno).

Parametry

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (tab?: Tab) => void

Zwroty

  • Obietkwarzeczenie<Tab | nieokreślony>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

getSelected()

Obietnice &leq; MV2 Wycofane
chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)

Użyj tabs.query {active: true}.

Pobiera kartę wybraną w określonym oknie.

Parametry

  • windowId

    number opcjonalny

    Domyślnie jest to bieżące okno.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (tab: Tab) => void

Zwroty

  • Obietnica<karta>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

getZoom()

Obietnice 
chrome.tabs.getZoom(
  tabId?: number,
  callback?: function,
)

Pobiera bieżący współczynnik powiększenia na określonej karcie.

Parametry

  • tabId

    number opcjonalny

    Identyfikator karty, z której ma zostać pobrany bieżący współczynnik powiększenia; domyślnie jest to aktywna karta bieżącego okna.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (zoomFactor: number) => void

    • zoomFactor

      liczba

      Bieżący współczynnik powiększenia karty.

Zwroty

  • Obietnice<number>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

getZoomSettings()

Obietnice 
chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
)

Pobiera bieżące ustawienia powiększenia na określonej karcie.

Parametry

  • tabId

    number opcjonalny

    Identyfikator karty, z której mają zostać pobrane bieżące ustawienia powiększenia; domyślnie jest to aktywna karta w bieżącym oknie.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (zoomSettings: ZoomSettings) => void

    • zoomSettings

      ZoomSettings

      bieżące ustawienia powiększenia karty;

Zwroty

  • Obietnice<ZoomSettings>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

goBack()

Obietnice Chrome 72 i nowsze 
chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)

Wróć do poprzedniej strony, jeśli jest dostępna.

Parametry

  • tabId

    number opcjonalny

    Identyfikator karty, do której chcesz wrócić; domyślnie jest to wybrana karta w bieżącym oknie.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

goForward()

Obietnice Chrome 72 i nowsze 
chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)

Przejdź do następnej strony, jeśli jest dostępna.

Parametry

  • tabId

    number opcjonalny

    Identyfikator karty, do której chcesz przejść; domyślnie jest to wybrana karta w bieżącym oknie.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

group()

Obietnica Chrome 88 lub nowszy 
chrome.tabs.group(
  options: object,
  callback?: function,
)

Dodaje co najmniej 1 kartę do określonej grupy lub, jeśli nie została określona żadna grupa, dodaje podane karty do nowo utworzonej grupy.

Parametry

  • Opcje

    Obiekt

    • createProperties

      object opcjonalne

      Konfiguracje do tworzenia grupy. Nie można go użyć, jeśli parametr groupId jest już określony.

      • windowId

        number opcjonalny

        Okno nowej grupy. Domyślnie jest to bieżące okno.

    • groupId

      number opcjonalny

      Identyfikator grupy, do której chcesz dodać karty. Jeśli nie zostanie określona, zostanie utworzona nowa grupa.

    • tabIds

      liczba | [liczba, ...liczba[]]

      Identyfikator karty lub lista identyfikatorów kart, które mają zostać dodane do określonej grupy.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (groupId: number) => void

    • groupId

      liczba

      Identyfikator grupy, do której zostały dodane karty.

Zwroty

  • Obietnice<number>

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

highlight()

Obietnice 
chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
)

Podświetla określone karty i skupia się na pierwszej z nich. Jeśli wybrana karta jest obecnie aktywna, nie będzie to miało żadnego wpływu.

Parametry

  • highlightInfo

    Obiekt

    • karty

      liczba | liczba[]

      Co najmniej 1 indeks karty do podświetlenia.

    • windowId

      number opcjonalny

      Okno zawierające karty.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (window: Window) => void

    • okno

      Okno

      Zawiera informacje o oknie, którego karty zostały wyróżnione.

Zwroty

  • Promise<windows.Window>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

insertCSS()

Obietki typu Promise &leq; MV2 Wycofane w Chrome 91
chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Zastąpione przez scripting.insertCSS w pliku manifestu V3.

Wstrzykuje kod CSS na stronie. Style wstawiane za pomocą tej metody można usunąć za pomocą scripting.removeCSS. Szczegółowe informacje znajdziesz w sekcji wstawiania programowego w dokumencie dotyczącym skryptów treści.

Parametry

  • tabId

    number opcjonalny

    Identyfikator karty, na której ma zostać wstawiony kod CSS; domyślnie jest to aktywna karta bieżącego okna.

  • szczegóły

    InjectDetails

    Szczegóły tekstu CSS do wstawienia. Musisz ustawić kod lub plik, ale nie możesz ustawić obu naraz.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

move()

Obietnice 
chrome.tabs.move(
  tabIds: number | number[],
  moveProperties: object,
  callback?: function,
)

Przenosi co najmniej 1 kartę na nowe miejsce w oknie lub do nowego okna. Pamiętaj, że karty można przenosić tylko do i z normalnych okien (window.type === „normal”).

Parametry

  • tabIds

    liczba | liczba[]

    Identyfikator karty lub lista identyfikatorów kart do przeniesienia.

  • moveProperties

    Obiekt

    • indeks

      liczba

      Miejsce, do którego chcesz przenieść okno. Aby umieścić kartę na końcu okna, użyj -1.

    • windowId

      number opcjonalny

      Domyślnie jest to okno, w którym znajduje się karta.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (tabs: Tab | Tab[]) => void

    • karty

      Karta | Karta[]

      Szczegóły dotyczące przeniesionych kart.

Zwroty

  • Obietnice<Karta | Karta[]>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

query()

Obietnice 
chrome.tabs.query(
  queryInfo: object,
  callback?: function,
)

Pobiera wszystkie karty, które mają określone właściwości, lub wszystkie karty, jeśli nie określono żadnych właściwości.

Parametry

  • queryInfo

    Obiekt

    • aktywna

      logiczna opcjonalna

      czy karty są aktywne w ich oknach.

    • audible

      logiczna opcjonalna

      Chrome 45 i nowsze

      czy karty są słyszalne.

    • autoDiscardable

      logiczna opcjonalna

      Chrome 54 lub nowszy

      Określa, czy karty mogą być automatycznie usuwane przez przeglądarkę, gdy zasoby są niskie.

    • currentWindow

      logiczna opcjonalna

      Czy karty znajdują się w bieżącym oknie.

    • odrzucono

      logiczna opcjonalna

      Chrome 54 lub nowszy

      Określa, czy karty mają zostać odrzucone. Odrzucona karta to karta, której zawartość została wyjęta z pamięci, ale nadal jest widoczna na pasku kart. Treści są ponownie wczytywane przy następnym włączeniu.

    • zamrożony

      logiczna opcjonalna

      Oczekuje

      Czy karty są wstrzymane. Zablokowana karta nie może wykonywać zadań, w tym modułów obsługi zdarzeń ani zegarów. Jest widoczna na pasku kart, a jej zawartość jest wczytana do pamięci. Po aktywacji jest odblokowany.

    • groupId

      number opcjonalny

      Chrome 88 lub nowszy

      Identyfikator grupy, w której znajdują się karty, lub tabGroups.TAB_GROUP_ID_NONE w przypadku kart niesgrupowanych.

    • wyróżniona

      logiczna opcjonalna

      Określa, czy karty są wyróżnione.

    • indeks

      number opcjonalny

      położenie kart w ich oknach.

    • lastFocusedWindow

      logiczna opcjonalna

      Czy karty znajdują się w ostatnim aktywnym oknie.

    • Wyciszono

      logiczna opcjonalna

      Chrome 45 i nowsze

      Czy karty są wyciszone.

    • przypięty

      logiczna opcjonalna

      Czy karty są przypięte.

    • status

      TabStatus opcjonalnie

      Stan wczytywania karty.

    • tytuł

      ciąg znaków opcjonalny

      dopasowywać tytuły stron do wzorca; Ta właściwość jest ignorowana, jeśli rozszerzenie nie ma uprawnienia "tabs".

    • URL

      ciąg znaków | ciągi znaków[] opcjonalnie

      Dopasowuj karty do co najmniej 1 wzorca adresu URL. Identyfikatory fragmentów nie pasują do siebie. Ta właściwość jest ignorowana, jeśli rozszerzenie nie ma uprawnienia "tabs".

    • windowId

      number opcjonalny

      Identyfikator nadrzędnego okna lub windows.WINDOW_ID_CURRENT w przypadku bieżącego okna.

    • windowType

      WindowType opcjonalny

      Typ okna, w którym znajdują się karty.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: Tab[]) => void

Zwroty

  • Obietnice<Tab[]>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

reload()

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

Załaduj ponownie kartę.

Parametry

  • tabId

    number opcjonalny

    Identyfikator karty do ponownego załadowania; domyślnie wybrana karta w bieżącym oknie.

  • reloadProperties

    object opcjonalne

    • bypassCache

      logiczna opcjonalna

      Określa, czy pominąć buforowanie lokalne. Domyślna wartość to false.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

remove()

Obietnice 
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

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

removeCSS()

Obietnice Chrome 87 i nowsze &leq; MV2 Wycofane w Chrome 91
chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

Zastąpione przez scripting.removeCSS w pliku manifestu V3.

Usuwa z strony kod CSS, który został wcześniej wstrzyknięty przez wywołanie scripting.insertCSS.

Parametry

  • tabId

    number opcjonalny

    Identyfikator karty, z której chcesz usunąć usługę porównywania cen. Domyślnie jest to aktywna karta w bieżącym oknie.

  • Szczegóły tekstu CSS, który chcesz usunąć. Musisz ustawić kod lub plik, ale nie możesz ustawić obu naraz.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

sendMessage()

Obietnice 
chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
  callback?: function,
)

Wysyła jedną wiadomość do skryptów treści na określonej karcie z opcjonalnym wywołaniem zwrotnym, które zostanie wykonane po otrzymaniu odpowiedzi. Zdarzenie runtime.onMessage jest wywoływane w każdym skrypcie treści uruchomionym na określonej karcie w bieżącym rozszerzeniu.

Parametry

  • tabId

    liczba

  • wiadomość

    każdy

    Wiadomość do wysłania. Ta wiadomość powinna być obiektem JSON.

  • Opcje

    object opcjonalne

    • documentId

      ciąg znaków opcjonalny

      Chrome 106 lub nowszy

      Wysyłanie wiadomości do konkretnego dokumentu oznaczonego jako documentId, a nie do wszystkich ramek na karcie.

    • frameId

      number opcjonalny

      Wysyłanie wiadomości do konkretnej ramki zidentyfikowanej przez frameId, a nie do wszystkich ramek na karcie.

  • wywołanie zwrotne

    function opcjonalny

    Chrome 99+

    Parametr callback ma postać:

    (response: any) => void

    • odpowiedź

      każdy

      Obiekt odpowiedzi JSON wysłany przez moduł obsługi wiadomości. Jeśli podczas łączenia z określoną kartą wystąpi błąd, funkcja wywołania zwrotnego zostanie wywołana bez argumentów, a wartość runtime.lastError zostanie ustawiona na komunikat o błędzie.

Zwroty

  • Promise<any>

    Chrome 99+

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

sendRequest()

Obietnice &leq; MV2 Wycofane
chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
)

Użyj wartości runtime.sendMessage.

Wysyła jedno żądanie do skryptów treści na określonej karcie z opcjonalnym wywołaniem zwrotnym, które ma być wykonane po otrzymaniu odpowiedzi. Zdarzenie extension.onRequest jest wywoływane w każdym skrypcie treści uruchomionym na określonej karcie w bieżącym rozszerzeniu.

Parametry

  • tabId

    liczba

  • żądanie

    każdy

  • wywołanie zwrotne

    function opcjonalny

    Chrome 99+

    Parametr callback ma postać:

    (response: any) => void

    • odpowiedź

      każdy

      Obiekt odpowiedzi JSON wysłany przez moduł obsługi żądania. Jeśli podczas łączenia z określoną kartą wystąpi błąd, funkcja wywołania zwrotnego zostanie wywołana bez argumentów, a wartość runtime.lastError zostanie ustawiona na komunikat o błędzie.

Zwroty

  • Promise<any>

    Chrome 99+

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

setZoom()

Obietnice 
chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
)

Powiększa określoną kartę.

Parametry

  • tabId

    number opcjonalny

    Identyfikator karty, którą chcesz powiększyć; domyślnie jest to aktywna karta bieżącego okna.

  • zoomFactor

    liczba

    Nowy współczynnik powiększenia. Wartość 0 ustawia kartę na bieżący domyślny współczynnik powiększenia. Wartości większe niż 0 określają współczynnik powiększenia (możliwe, że inny niż domyślny) dla karty.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

setZoomSettings()

Obietnice 
chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
)

Ustawia ustawienia powiększenia dla określonej karty, które określają sposób obsługi zmian powiększenia. Te ustawienia są resetowane do wartości domyślnych po przejściu na kartę.

Parametry

  • tabId

    number opcjonalny

    Identyfikator karty, dla której mają zostać zmienione ustawienia zooma. Domyślnie jest to aktywna karta w bieżącym oknie.

  • zoomSettings

    ZoomSettings

    Określa, jak i w jakim zakresie są obsługiwane zmiany powiększenia.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

ungroup()

Obietnica Chrome 88 lub nowszy 
chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
)

Usuwa co najmniej 1 kartę z odpowiednich grup. Jeśli jakiekolwiek grupy okażą się puste, zostaną usunięte.

Parametry

  • tabIds

    liczba | [liczba, ...liczba[]]

    Identyfikator karty lub lista identyfikatorów kart, które mają zostać usunięte z odpowiednich grup.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

update()

Obietnice 
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 elementach updateProperties, nie są modyfikowane.

Parametry

  • tabId

    number opcjonalny

    Domyślnie jest to wybrana karta w bieżącym oknie.

  • updateProperties

    Obiekt

    • aktywna

      logiczna opcjonalna

      Określa, czy karta ma być aktywna. Nie ma wpływu na to, czy okno jest aktywne (patrz windows.update).

    • autoDiscardable

      logiczna opcjonalna

      Chrome 54 lub nowszy

      Określa, czy przeglądarka powinna automatycznie odrzucić kartę, gdy zabraknie zasobów.

    • wyróżniona

      logiczna opcjonalna

      Dodaje lub usuwa kartę z bieżącego zaznaczenia.

    • Wyciszono

      logiczna opcjonalna

      Chrome 45 i nowsze

      Określa, czy karta ma być wyciszona.

    • openerTabId

      number opcjonalny

      Identyfikator karty, która otworzyła tę kartę. Jeśli jest określona, karta otwierająca musi znajdować się w tym samym oknie co ta karta.

    • przypięty

      logiczna opcjonalna

      Określa, czy karta ma być przypięta.

    • wybrano

      logiczna opcjonalna

      Wycofane

      Użyj podświetlonego.

      Określa, czy karta ma być wybrana.

    • URL

      ciąg znaków opcjonalny

      Adres URL, do którego ma prowadzić karta. Adresy URL w języku JavaScript nie są obsługiwane. Zamiast nich używaj adresów scripting.executeScript.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (tab?: Tab) => void

    • tabulator

      Tabulator opcjonalny

      Szczegóły dotyczące zaktualizowanej karty Obiekt tabs.Tab nie zawiera elementów url, pendingUrl, title i favIconUrl, jeśli nie określono uprawnienia "tabs".

Zwroty

  • Obietkwarzeczenie<Tab | nieokreślony>

    Chrome 88 lub nowszy

    Obietnice są obsługiwane w pliku manifestu w wersji 3 i późniejszych, ale wywołania zwrotne są dostępne ze względu na zgodność wsteczną. Nie możesz używać obu w tym samym wywołaniu funkcji. Obiet na obietnice zwracany jest z tym samym typem, który jest przekazywany do funkcji zwracającej wywołanie zwrotne.

Wydarzenia

onActivated

chrome.tabs.onActivated.addListener(
  callback: function,
)

Wyzwala się, gdy aktywna karta w oknie ulegnie zmianie. Pamiętaj, że w momencie wywołania tego zdarzenia adres URL karty może nie być ustawiony, ale możesz słuchać zdarzeń onUpdated, aby otrzymywać powiadomienia o ustawieniu adresu URL.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (activeInfo: object) => void

    • activeInfo

      Obiekt

      • tabId

        liczba

        Identyfikator karty, która stała się aktywna.

      • windowId

        liczba

        Identyfikator okna, w którym nastąpiła zmiana aktywnej karty.

onActiveChanged

&leq; MV2 Wycofane
chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Użyj wartości tabs.onActivated.

Wyzwala się, gdy wybrana karta w oknie ulegnie zmianie. Pamiętaj, że w momencie wywołania tego zdarzenia adres URL karty może nie być ustawiony, ale możesz odbierać powiadomienia o ustawieniu adresu URL, słuchając zdarzeń tabs.onUpdated.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (tabId: number, selectInfo: object) => void

    • tabId

      liczba

    • selectInfo

      Obiekt

      • windowId

        liczba

        Identyfikator okna, w którym nastąpiła zmiana wybranej karty.

onAttached

chrome.tabs.onAttached.addListener(
  callback: function,
)

Wywoływany, gdy karta jest przypięta do okna, na przykład dlatego, że została przeniesiona między oknami.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (tabId: number, attachInfo: object) => void

    • tabId

      liczba

    • attachInfo

      Obiekt

      • newPosition

        liczba

      • newWindowId

        liczba

onCreated

chrome.tabs.onCreated.addListener(
  callback: function,
)

Uruchamiane, gdy utworzysz kartę. Pamiętaj, że adres URL karty i przynależność do grupy kart mogą nie być ustawione w momencie wywołania tego zdarzenia, ale możesz odbierać zdarzenia onUpdated, aby otrzymywać powiadomienia o ustawieniu adresu URL lub dodaniu karty do grupy kart.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (tab: Tab) => void

onDetached

chrome.tabs.onDetached.addListener(
  callback: function,
)

Wywoływany, gdy karta jest odłączona od okna, na przykład dlatego, że została przeniesiona między oknami.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (tabId: number, detachInfo: object) => void

    • tabId

      liczba

    • detachInfo

      Obiekt

      • oldPosition

        liczba

      • oldWindowId

        liczba

onHighlightChanged

&leq; MV2 Wycofane
chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Użyj wartości tabs.onHighlighted.

Wywoływany, gdy podświetlone lub wybrane karty w oknie ulegną zmianie.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (selectInfo: object) => void

    • selectInfo

      Obiekt

      • tabIds

        number[]

        Wszystkie wyróżnione karty w oknie.

      • windowId

        liczba

        Okno, którego karty uległy zmianie.

onHighlighted

chrome.tabs.onHighlighted.addListener(
  callback: function,
)

Wywoływany, gdy podświetlone lub wybrane karty w oknie ulegną zmianie.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (highlightInfo: object) => void

    • highlightInfo

      Obiekt

      • tabIds

        number[]

        Wszystkie wyróżnione karty w oknie.

      • windowId

        liczba

        Okno, którego karty uległy zmianie.

onMoved

chrome.tabs.onMoved.addListener(
  callback: function,
)

Wywoływane, gdy karta jest przenoszona w oknie. Wywoływane jest tylko jedno zdarzenie przenoszenia, które reprezentuje kartę przeniesioną bezpośrednio przez użytkownika. Zdarzenia przenoszenia nie są wywoływane w przypadku innych kart, które muszą zostać przeniesione w odpowiedzi na ręczne przeniesienie karty. To zdarzenie nie jest wywoływane, gdy karta jest przenoszona między oknami. Więcej informacji znajdziesz w artykule tabs.onDetached.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (tabId: number, moveInfo: object) => void

    • tabId

      liczba

    • moveInfo

      Obiekt

      • fromIndex

        liczba

      • toIndex

        liczba

      • windowId

        liczba

onRemoved

chrome.tabs.onRemoved.addListener(
  callback: function,
)

Wywoływane po zamknięciu karty.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (tabId: number, removeInfo: object) => void

    • tabId

      liczba

    • removeInfo

      Obiekt

      • isWindowClosing

        wartość logiczna

        Wartość true, gdy karta została zamknięta, ponieważ zamknięto jej okno nadrzędne.

      • windowId

        liczba

        Okno, którego karta została zamknięta.

onReplaced

chrome.tabs.onReplaced.addListener(
  callback: function,
)

Wywoływany, gdy karta jest zastępowana inną kartą z powodu prerenderowania lub instant.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (addedTabId: number, removedTabId: number) => void

    • addedTabId

      liczba

    • removedTabId

      liczba

onSelectionChanged

&leq; MV2 Wycofane
chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Użyj wartości tabs.onActivated.

Wyzwala się, gdy wybrana karta w oknie ulegnie zmianie.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (tabId: number, selectInfo: object) => void

    • tabId

      liczba

    • selectInfo

      Obiekt

      • windowId

        liczba

        Identyfikator okna, w którym nastąpiła zmiana wybranej karty.

onUpdated

chrome.tabs.onUpdated.addListener(
  callback: function,
)

Wywoływane, gdy karta jest aktualizowana.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (tabId: number, changeInfo: object, tab: Tab) => void

    • tabId

      liczba

    • changeInfo

      Obiekt

      • audible

        logiczna opcjonalna

        Chrome 45 i nowsze

        Nowy stan dźwiękowy karty.

      • autoDiscardable

        logiczna opcjonalna

        Chrome 54 lub nowszy

        Nowy stan karty, który można automatycznie odrzucić.

      • odrzucono

        logiczna opcjonalna

        Chrome 54 lub nowszy

        Nowy stan odrzucenia karty.

      • favIconUrl

        ciąg znaków opcjonalny

        Nowy adres URL ikony karty.

      • zamrożony

        logiczna opcjonalna

        Oczekuje

        Nowy stan zamrożenia karty.

      • groupId

        number opcjonalny

        Chrome 88 lub nowszy

        Nowa grupa karty.

      • mutedInfo

        MutedInfo opcjonalnie

        Chrome 46 lub nowszy

        Nowy stan wyciszenia karty i przyczyna zmiany.

      • przypięty

        logiczna opcjonalna

        Nowy stan przypięcia karty.

      • status

        TabStatus opcjonalnie

        Stan wczytywania karty.

      • tytuł

        ciąg znaków opcjonalny

        Chrome 48+

        Nowy tytuł karty.

      • URL

        ciąg znaków opcjonalny

        Adres URL karty, jeśli się zmienił.

    • tabulator

      Tabulator

onZoomChange

chrome.tabs.onZoomChange.addListener(
  callback: function,
)

Uruchamiane, gdy karta jest powiększana.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (ZoomChangeInfo: object) => void

    • ZoomChangeInfo

      Obiekt

      • newZoomFactor

        liczba

      • oldZoomFactor

        liczba

      • tabId

        liczba

      • zoomSettings

        ZoomSettings