Açıklama
Tarayıcının sekme gruplandırma sistemiyle etkileşim kurmak için chrome.tabGroups
API'yi kullanın. Bu API'yi tarayıcıdaki sekme gruplarını değiştirmek ve yeniden düzenlemek için kullanabilirsiniz. Sekmeleri gruplandırmak, gruplandırmayı iptal etmek veya gruplarda hangi sekmelerin olduğunu sorgulamak için chrome.tabs
API'yi kullanın.
İzinler
tabGroups
Kullanılabilirlik
Türler
Color
Grubun rengi.
Enum
"grey"
"pink"
TabGroup
Özellikler
-
daraltılmış
boolean
Grubun daraltılıp daraltılmadığı. Daraltılmış grup, sekmeleri gizlenen gruplardır.
-
renk
Grubun rengi.
-
id
sayı
Grubun kimliği. Grup kimlikleri, tarayıcı oturumunda benzersizdir.
-
title
string isteğe bağlı
Grubun başlığı.
-
windowId
sayı
Grubu içeren pencerenin kimliği.
Özellikler
TAB_GROUP_ID_NONE
Bir grubun yokluğunu temsil eden bir kimlik.
Değer
-1
Yöntemler
get()
chrome.tabGroups.get(
groupId: number,
callback?: function,
)
Belirtilen grup hakkındaki ayrıntıları getirir.
Parametreler
-
groupId
sayı
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(group: TabGroup) => void
-
grup
-
İlerlemeler
-
Promise<TabGroup>
Chrome 90 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
move()
chrome.tabGroups.move(
groupId: number,
moveProperties: object,
callback?: function,
)
Grubu ve grubun içindeki tüm sekmelerini yeni bir pencereye taşır.
Parametreler
-
groupId
sayı
Taşınacak grubun kimliği.
-
moveProperties
nesne
-
indeks
sayı
Grubun taşınacağı konum. Grubu pencerenin sonuna yerleştirmek için
-1
tuşunu kullanın. -
windowId
numara isteğe bağlı
Grubun taşınacağı pencere. Varsayılan olarak grubun şu anda bulunduğu penceredir. Grupların yalnızca
windows.WindowType
türündeki"normal"
ile pencerelere ve pencerelerden taşınabileceğini unutmayın.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(group?: TabGroup) => void
-
grup
TabGroup isteğe bağlı
Taşınan grupla ilgili ayrıntılar.
-
İlerlemeler
-
Promise<TabGroup | undefined>
Chrome 90 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
query()
chrome.tabGroups.query(
queryInfo: object,
callback?: function,
)
Belirtilen özelliklere sahip tüm grupları veya herhangi bir özellik belirtilmediyse tüm grupları alır.
Parametreler
-
queryInfo
nesne
-
daraltılmış
boole isteğe bağlı
Grupların daraltılıp daraltılmadığı.
-
renk
Renk isteğe bağlı
Grupların rengi.
-
title
string isteğe bağlı
Grup başlıklarını belirli bir kalıpla eşleştirin.
-
windowId
numara isteğe bağlı
Üst pencerenin kimliği veya geçerli pencere için
windows.WINDOW_ID_CURRENT
.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: TabGroup[]) => void
-
sonuç
TabGroup[]
-
İlerlemeler
-
Promise<TabGroup[]>
Chrome 90 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
update()
chrome.tabGroups.update(
groupId: number,
updateProperties: object,
callback?: function,
)
Grubun özelliklerini değiştirir. updateProperties
içinde belirtilmeyen özellikler değiştirilmez.
Parametreler
-
groupId
sayı
Değiştirilecek grubun kimliği.
-
updateProperties
nesne
-
daraltılmış
boole isteğe bağlı
Grubun daraltılıp daraltılmayacağı.
-
renk
Renk isteğe bağlı
Grubun rengi.
-
title
string isteğe bağlı
Grubun başlığı.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(group?: TabGroup) => void
-
grup
TabGroup isteğe bağlı
Güncellenen grupla ilgili ayrıntılar.
-
İlerlemeler
-
Promise<TabGroup | undefined>
Chrome 90 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
Etkinlikler
onCreated
chrome.tabGroups.onCreated.addListener(
callback: function,
)
Grup oluşturulduğunda tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(group: TabGroup) => void
-
grup
-
onMoved
chrome.tabGroups.onMoved.addListener(
callback: function,
)
Bir grup pencere içinde taşındığında tetiklenir. Taşıma etkinlikleri, gruptaki bağımsız sekmeler ve grubun kendisi için yine etkinleşir. Bir grup pencereler arasında taşındığında bu etkinlik tetiklenmez. Bunun yerine, bir pencereden kaldırılıp başka bir pencerede oluşturulur.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(group: TabGroup) => void
-
grup
-
onRemoved
chrome.tabGroups.onRemoved.addListener(
callback: function,
)
Bir grup, doğrudan kullanıcı tarafından veya sıfır sekme içerdiği için otomatik olarak kapatıldığında tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(group: TabGroup) => void
-
grup
-
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
Bir grup güncellendiğinde tetiklenir.