chrome.tabGroups

Opis

Interfejs API chrome.tabGroups umożliwia interakcję z systemem grupowania kart przeglądarki. Za pomocą tego interfejsu API możesz modyfikować grupy kart i zmieniać ich kolejność w przeglądarce. Aby grupować i rozgrupowywać karty lub sprawdzać, które karty należą do grup, użyj interfejsu API chrome.tabs.

Uprawnienia

tabGroups

Dostępność

Chrome 89 i nowsze wersje MV3 i nowsze

Typy

Color

Kolor grupy.

Enum

TabGroup

Właściwości

  • zwinięto

    boolean

    Określa, czy grupa jest zwinięta. Grupa zwinięta to grupa z ukrytymi kartami.

  • kolor

    Kolor

    Kolor grupy.

  • id

    Liczba

    Identyfikator grupy. Identyfikatory grup są unikalne w obrębie sesji przeglądarki.

  • title

    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 brak grupy.

Wartość

–1

Metody

get()

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

Pobiera informacje o określonej grupie.

Parametry

  • groupId

    Liczba

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (group: TabGroup)=>void

Akcje powrotne

  • Promise<TabGroup>

    Chrome 90 i nowsze

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika 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 w nowym oknie.

Parametry

  • groupId

    Liczba

    Identyfikator grupy do przeniesienia.

  • moveProperties

    obiekt

    • indeks

      Liczba

      Pozycja, do której chcesz przenieść grupę. Użyj -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 znajduje się obecnie grupa. Pamiętaj, że grupy można przenosić tylko do i z okien z windows.WindowType typu "normal".

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (group?: TabGroup)=>void

    • grupa

      TabGroup opcjonalnie

      Szczegółowe informacje o przeniesionej grupie.

Akcje powrotne

  • Promise<TabGroup|undefined>

    Chrome 90 i nowsze

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

query()

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

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ęto

      wartość logiczna opcjonalna

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

    • kolor

      Kolor opcjonalny

      Kolor grup.

    • title

      ciąg znaków opcjonalny

      Dopasuj nazwy grup do wzorca.

    • windowId

      Liczba opcjonalnie

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: TabGroup[])=>void

Akcje powrotne

  • Promise<TabGroup[]>

    Chrome 90 i nowsze

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika 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 polu updateProperties, nie są modyfikowane.

Parametry

  • groupId

    Liczba

    Identyfikator grupy, którą chcesz zmodyfikować.

  • updateProperties

    obiekt

    • zwinięto

      wartość logiczna opcjonalna

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

    • kolor

      Kolor opcjonalny

      Kolor grupy.

    • title

      ciąg znaków opcjonalny

      Nazwa grupy.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (group?: TabGroup)=>void

    • grupa

      TabGroup opcjonalnie

      Szczegółowe informacje o zaktualizowanej grupie.

Akcje powrotne

  • Promise<TabGroup|undefined>

    Chrome 90 i nowsze

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika 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 uruchamiane w przypadku poszczególnych kart w grupie, a także samej grupy. To zdarzenie nie jest wywoływane po przeniesieniu grupy między oknami; zamiast tego zostanie usunięte z jednego okna i utworzone w innym.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (group: TabGroup)=>void

onRemoved

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

Uruchamiane, gdy grupa jest zamknięta – bezpośrednio przez użytkownika lub automatycznie, ponieważ zawiera ona zero kart.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (group: TabGroup)=>void

onUpdated

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

Uruchamiane po aktualizacji grupy.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (group: TabGroup)=>void