browser.tabGroups

Açıklama

Tarayıcının sekme gruplandırma sistemiyle etkileşimde bulunmak için chrome.tabGroups API'yi kullanın. Tarayıcıdaki sekme gruplarını değiştirmek ve yeniden düzenlemek için bu API'yi kullanabilirsiniz. Sekmeleri gruplandırmak ve gruplandırmasını kaldırmak ya da gruplarda hangi sekmelerin olduğunu sorgulamak için chrome.tabs API'sini kullanın.

İzinler

tabGroups

Kullanılabilirlik

Chrome 89 ve sonraki sürümler Chrome 148'den itibaren browser.* MV3 ve sonraki sürümler

Türler

Color

Grubun rengi.

Enum

"grey"

"mavi"

"kırmızı"

"sarı"

"yeşil"

"pembe"

"mor"

"cyan"

"turuncu"

TabGroup

Özellikler

  • daraltıldı

    boole

    Grubun daraltılıp daraltılmadığı. Daraltılmış grup, sekmeleri gizlenmiş bir gruptur.

  • renk

    Renk

    Grubun rengi.

  • id

    sayı

    Grubun kimliği. Grup kimlikleri, tarayıcı oturumunda benzersizdir.

  • paylaşıldı

    boole

    Chrome 137 ve sonraki sürümler Chrome 148'den itibaren browser.*

    Grubun paylaşılıp paylaşılmadığı.

  • title

    string isteğe bağlı

    Grubun başlığı.

  • windowId

    sayı

    Grubu içeren pencerenin kimliği.

Özellikler

TAB_GROUP_ID_NONE

Bir grubun olmadığını gösteren kimlik.

Değer

-1

Yöntemler

get()

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

Belirtilen grupla ilgili ayrıntıları alır.

Parametreler

  • groupId

    sayı

İadeler

  • Promise<TabGroup>

    Chrome 90 ve sonraki sürümler Chrome 148'den itibaren browser.*

move()

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

Grubu ve tüm sekmelerini kendi penceresinde veya 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şlarını kullanın.

    • windowId

      number isteğe bağlı

      Grubun taşınacağı pencere. Varsayılan olarak grubun şu anda bulunduğu pencereye taşınır. Grupların yalnızca windows.WindowType türü "normal" olan pencerelere taşınabileceğini unutmayın.

İadeler

  • Promise<TabGroup | undefined>

    Chrome 90 ve sonraki sürümler Chrome 148'den itibaren browser.*

query()

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

Belirtilen özelliklere sahip tüm grupları veya özellik belirtilmemişse tüm grupları alır.

Parametreler

  • queryInfo

    nesne

    • daraltıldı

      boole isteğe bağlı

      Grupların daraltılıp daraltılmadığı.

    • renk

      Renk isteğe bağlı

      Grupların rengi.

    • paylaşıldı

      boole isteğe bağlı

      Chrome 137 ve sonraki sürümler Chrome 148'den itibaren browser.*

      Grubun paylaşılıp paylaşılmadığı.

    • title

      string isteğe bağlı

      Grup başlıklarını bir kalıpla eşleştirin.

    • windowId

      number isteğe bağlı

      Üst pencerenin kimliği veya geçerli pencere için windows.WINDOW_ID_CURRENT.

İadeler

  • Promise<TabGroup[]>

    Chrome 90 ve sonraki sürümler Chrome 148'den itibaren browser.*

update()

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

Bir 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ıldı

      boole isteğe bağlı

      Grubun daraltılıp daraltılmayacağını belirtir.

    • renk

      Renk isteğe bağlı

      Grubun rengi.

    • title

      string isteğe bağlı

      Grubun başlığı.

İadeler

  • Promise<TabGroup | undefined>

    Chrome 90 ve sonraki sürümler Chrome 148'den itibaren browser.*

Etkinlikler

onCreated

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

Bir grup oluşturulduğunda tetiklenir.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (group: TabGroup) => void

onMoved

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

Bir grup, pencere içinde taşındığında tetiklenir. Taşıma etkinlikleri, grubun kendisinin yanı sıra gruptaki sekmeler için de tetiklenir. Bu etkinlik, bir grup pencereler arasında taşındığında tetiklenmez. Bunun yerine, bir pencereden kaldırılır ve başka bir pencerede oluşturulur.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (group: TabGroup) => void

onRemoved

browser.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

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (group: TabGroup) => void

onUpdated

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

Bir grup güncellendiğinde tetiklenir.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (group: TabGroup) => void