browser.tabGroups

Opis

Użyj interfejsu API chrome.tabGroups, aby wejść w interakcję z systemem grupowania kart w przeglądarce. Za pomocą tego interfejsu API możesz modyfikować i zmieniać kolejność grup kart w przeglądarce. Aby grupować i rozgrupowywać karty lub sprawdzać, które karty są w grupach, użyj interfejsu API chrome.tabs.

Uprawnienia

tabGroups

Dostępność

Chrome 89+ browser.* od Chrome 148 MV3+

Typy

Color

kolor grupy,

Typ wyliczeniowy

"grey"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"orange"

TabGroup

Właściwości

  • zwinięty

    wartość logiczna

    Czy grupa jest zwinięta. Zwijana grupa to taka, której karty są ukryte.

  • kolor

    Kolor

    kolor grupy,

  • id

    liczba

    Identyfikator grupy. Identyfikatory grup są unikalne w ramach sesji przeglądarki.

  • udostępnioną

    wartość logiczna

    Chrome 137 lub nowsza wersja browser.* od Chrome 148

    Czy grupa jest udostępniona.

  • tytuł

    ciąg znaków opcjonalny

    Nazwa grupy.

  • windowId

    liczba

    Identyfikator okna zawierającego grupę.

Właściwości

TAB_GROUP_ID_NONE

Identyfikator, który reprezentuje brak grupy.

Wartość

-1

Metody

get()

browser.tabGroups.get(
  groupId: number,
): Promise<TabGroup>

Pobiera szczegółowe informacje o określonej grupie.

Parametry

  • groupId

    liczba

Zwroty

  • Promise<TabGroup>

    Chrome 90 lub nowsza browser.* od Chrome 148

move()

browser.tabGroups.move(
  groupId: number,
  moveProperties: object,
): Promise<TabGroup | undefined>

Przenosi grupę i wszystkie jej karty w obrębie okna lub do nowego okna.

Parametry

  • groupId

    liczba

    Identyfikator grupy, którą chcesz przenieść.

  • moveProperties

    obiekt

    • indeks

      liczba

      Pozycja, na którą chcesz przenieść grupę. Aby umieścić grupę na końcu okna, naciśnij -1.

    • windowId

      number optional

      Okno, do którego chcesz przenieść grupę. Domyślnie jest to okno, w którym obecnie znajduje się grupa. Pamiętaj, że grupy można przenosić tylko do i z okien typu "normal", które mają windows.WindowType.

Zwroty

  • Promise<TabGroup | undefined>

    Chrome 90 lub nowsza browser.* od Chrome 148

query()

browser.tabGroups.query(
  queryInfo: object,
): Promise<TabGroup[]>

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

Parametry

  • queryInfo

    obiekt

    • zwinięty

      boolean opcjonalne

      Czy grupy są zwinięte.

    • kolor

      Color opcjonalny

      Kolor grup.

    • udostępnioną

      boolean opcjonalne

      Chrome 137 lub nowsza wersja browser.* od Chrome 148

      Czy grupa jest udostępniona.

    • tytuł

      ciąg znaków opcjonalny

      Dopasuj tytuły grup do wzorca.

    • windowId

      number optional

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

Zwroty

  • Promise<TabGroup[]>

    Chrome 90 lub nowsza browser.* od Chrome 148

update()

browser.tabGroups.update(
  groupId: number,
  updateProperties: object,
): Promise<TabGroup | undefined>

Modyfikuje właściwości grupy. Właściwości, które nie są określone w pliku updateProperties, nie są modyfikowane.

Parametry

  • groupId

    liczba

    Identyfikator grupy, którą chcesz zmodyfikować.

  • updateProperties

    obiekt

    • zwinięty

      boolean opcjonalne

      Określa, czy grupa ma być zwinięta.

    • kolor

      Color opcjonalny

      Kolor grupy.

    • tytuł

      ciąg znaków opcjonalny

      Nazwa grupy.

Zwroty

  • Promise<TabGroup | undefined>

    Chrome 90 lub nowsza browser.* od Chrome 148

Wydarzenia

onCreated

browser.tabGroups.onCreated.addListener(
  callback: function,
)

Uruchamiane po utworzeniu grupy.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (group: TabGroup) => void

onMoved

browser.tabGroups.onMoved.addListener(
  callback: function,
)

Uruchamiane, gdy grupa zostanie przeniesiona w obrębie okna. Zdarzenia przenoszenia są nadal wywoływane w przypadku poszczególnych kart w grupie, a także samej grupy. To zdarzenie nie jest wywoływane, gdy grupa jest przenoszona między oknami. Zamiast tego zostanie ona usunięta z jednego okna i utworzona w innym.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (group: TabGroup) => void

onRemoved

browser.tabGroups.onRemoved.addListener(
  callback: function,
)

Uruchamiane, gdy grupa zostanie zamknięta bezpośrednio przez użytkownika lub automatycznie, ponieważ nie zawierała żadnych kart.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (group: TabGroup) => void

onUpdated

browser.tabGroups.onUpdated.addListener(
  callback: function,
)

Uruchamiane po zaktualizowaniu grupy.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (group: TabGroup) => void