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ść
Typy
Color
Kolor grupy.
Typ wyliczeniowy
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 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()
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
-
grupa
-
Zwroty
-
Promise<TabGroup>
Chrome 90 i nowszeObietnice 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()
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.
-
Zwroty
-
Promise<TabGroup | undefined>
Chrome 90 i nowszeObietnice 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()
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
-
wynik
TabGroup[]
-
Zwroty
-
Promise<TabGroup[]>
Chrome 90 i nowszeObietnice 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()
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.
-
Zwroty
-
Promise<TabGroup | undefined>
Chrome 90 i nowszeObietnice 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
-
grupa
-
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
-
grupa
-
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
-
grupa
-
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
Uruchamiane po aktualizacji grupy.