chrome.tabGroups

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 ve gruplarını çözmek ya da gruplardaki sekmeleri sorgulamak için chrome.tabs API'sini kullanın.

İzinler

tabGroups

Kullanılabilirlik

Chrome 89+ MV3+

Türler

Color

Grubun rengi.

Enum

"grey"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"orange"

TabGroup

Özellikler

  • daraltıldı

    boolean

    Grubun daraltılıp daraltılmadığı Daraltılmış bir grubun sekmeleri gizlenir.

  • renk

    Renk

    Grubun rengi.

  • id

    sayı

    Grubun kimliği. Grup kimlikleri, tarayıcı oturumu içinde benzersizdir.

  • paylaşıldı

    boolean

    Chrome 137 ve sonraki sürümler

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

  • title

    dize 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()

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

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

Parametreler

  • groupId

    sayı

İadeler

  • Promise<TabGroup>

    Chrome 90 veya daha yeni bir sürüm

move()

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

Grubu ve penceresindeki tüm sekmeleri penceresinde veya yeni bir pencerede 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 simgesini kullanın.

    • windowId

      number isteğe bağlı

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

İadeler

  • Promise<TabGroup | undefined>

    Chrome 90 veya daha yeni bir sürüm

query()

chrome.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ı

      boolean isteğe bağlı

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

    • renk

      Renk isteğe bağlı

      Grupların rengi.

    • paylaşıldı

      boolean isteğe bağlı

      Chrome 137 ve sonraki sürümler

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

    • title

      dize 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 veya daha yeni bir sürüm

update()

chrome.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ı

      boolean isteğe bağlı

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

    • renk

      Renk isteğe bağlı

      Grubun rengi.

    • title

      dize isteğe bağlı

      Grubun başlığı.

İadeler

  • Promise<TabGroup | undefined>

    Chrome 90 veya daha yeni bir sürüm

Etkinlikler

onCreated

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

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

Bir grup pencere içinde taşındığında tetiklenir. Taşıma etkinlikleri, grubun kendisi için olduğu kadar grup içindeki sekmeler için de tetiklenmeye devam eder. 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

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

  • callback

    işlev

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

    (group: TabGroup) => void

onUpdated

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