chrome.tabGroups

Opis

Do interakcji z systemem grupowania kart przeglądarki używaj interfejsu API chrome.tabGroups. Za pomocą tego interfejsu API możesz modyfikować i zmieniać kolejność grup kart w przeglądarce. Aby pogrupować i rozgrupować karty lub zadać pytanie, które karty są w grupach, użyj interfejsu API chrome.tabs.

Uprawnienia

tabGroups

Dostępność

Chrome w wersji 89 lub nowszej MV3 lub nowszy

Typy

Color

Kolor grupy.

Typ wyliczeniowy

"szary"

"niebieski"

"czerwony"

"żółty"

"green"

"różowy"

"fioletowy"

"błękitny"

"pomarańczowy"

TabGroup

Właściwości

  • zwinięto

    wartość logiczna

    Określa, czy grupa jest zwinięta. Zwinięta grupa to taka, w której karty są ukryte.

  • kolor

    Kolor

    Kolor grupy.

  • id

    liczba

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

  • tytuł

    ciąg znaków opcjonalny

    Nazwa grupy.

  • windowId

    liczba

    Identyfikator okna zawierającego grupę.

Właściwości

TAB_GROUP_ID_NONE

Identyfikator wskazujący nieobecność grupy.

Wartość

–1

Metody

get()

Obietnica 
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

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

Parametry

  • groupId

    liczba

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (group: TabGroup) => void
    .

Zwroty

  • Obietnica<TabGroup>

    Chrome w wersji 90 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

move()

Obietnica 
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

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

Parametry

  • groupId

    liczba

    Identyfikator grupy do przeniesienia.

  • moveProperties

    Obiekt

    • indeks

      liczba

      Pozycja, na którą zostanie przeniesiona grupa. Użyj klawisza -1, aby umieścić grupę na końcu okna.

    • windowId

      liczba opcjonalnie

      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 okien o typie windows.WindowType "normal" i z nich.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (group?: TabGroup) => void
    .

    • grupa

      Opcjonalne TabGroup

      Szczegółowe informacje o przeniesionej grupie.

Zwroty

  • Obietnica<TabGroup | niezdefiniowane>

    Chrome w wersji 90 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

query()

Obietnica 
chrome.tabGroups.query(
  queryInfo: object,
  callback?: function,
)

Pobiera wszystkie grupy o określonych właściwościach lub wszystkie grupy, jeśli nie określono żadnych właściwości.

Parametry

  • queryInfo

    Obiekt

    • zwinięto

      Wartość logiczna opcjonalna

      Określa, czy grupy są zwinięte.

    • kolor

      Kolor opcjonalny

      Kolor grup.

    • tytuł

      ciąg znaków opcjonalny

      Dopasuj tytuły do wzorca.

    • windowId

      liczba opcjonalnie

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: TabGroup[]) => void
    .

Zwroty

  • Obietnica<TabGroup[]>

    Chrome w wersji 90 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

update()

Obietnica 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

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

Parametry

  • groupId

    liczba

    Identyfikator grupy do zmodyfikowania.

  • updateProperties

    Obiekt

    • zwinięto

      Wartość logiczna opcjonalna

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

    • kolor

      Kolor opcjonalny

      Kolor grupy.

    • tytuł

      ciąg znaków opcjonalny

      Nazwa grupy.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (group?: TabGroup) => void
    .

    • grupa

      Opcjonalne TabGroup

      Szczegółowe informacje o zaktualizowanej grupie.

Zwroty

  • Obietnica<TabGroup | niezdefiniowane>

    Chrome w wersji 90 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

Wydarzenia

onCreated

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

Uruchamiane po utworzeniu grupy.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (group: TabGroup) => void
    .

onMoved

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

Uruchamiane, gdy grupa zostanie przeniesiona w oknie. Zdarzenia przenoszenia są nadal wywoływane zarówno dla poszczególnych kart w grupie, jak i dla samej grupy. To zdarzenie nie jest wywoływane, gdy grupa jest przenoszona między oknami. zostanie usunięta z jednego okna, a utworzona w innym.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (group: TabGroup) => void
    .

onRemoved

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

Uruchamiane po zamknięciu grupy – bezpośrednio przez użytkownika lub automatycznie, ponieważ nie zawierała żadnych kart.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (group: TabGroup) => void
    .

onUpdated

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

Uruchamiane po zaktualizowaniu grupy.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (group: TabGroup) => void
    .