chrome.tabGroups

Açıklama

Tarayıcı sekme gruplandırma sistemiyle etkileşime geçmek 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 grupları çözmek ya da gruplardaki sekmeleri sorgulamak için chrome.tabs API'yi kullanın.

İzinler

tabGroups

Kullanılabilirlik

Chrome 89 ve üzeri MV3 ve üzeri

Türler

Color

Grubun rengi.

Enum

"gri"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"orange"

TabGroup

Özellikler

  • daraltıldı

    boolean

    Grubun daraltılıp daraltılmadığı. Daraltılmış grupların sekmeleri gizlenir.

  • renk

    Renk

    Grubun rengi.

  • id

    sayı

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

  • paylaşıldı

    boolean

    Beklemede

    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 bulunmadığını gösteren kimlik.

Değer

-1

Yöntemler

get()

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

Belirtilen grupla ilgili ayrıntıları getirir.

Parametreler

  • groupId

    sayı

  • callback

    işlev isteğe bağlı

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

    (group: TabGroup) => void

İadeler

  • Promise<TabGroup>

    Chrome 90 ve üzeri sürümler

    Sözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türün aynısıyla çözülür.

move()

Promise 
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

Grubu ve tüm sekmelerini kendi 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 şu anda bulunduğu penceredir. Grupların yalnızca "normal" türüne sahip windows.WindowType pencerelerine ve pencerelerden taşınabileceğini unutmayın.

  • callback

    işlev 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.

İadeler

  • Promise<TabGroup | undefined>

    Chrome 90 ve üzeri sürümler

    Sözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türün aynısıyla çözülür.

query()

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

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ı

      Beklemede

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

    • title

      dize isteğe bağlı

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

    • windowId

      number isteğe bağlı

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

  • callback

    işlev isteğe bağlı

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

    (result: TabGroup[]) => void

İadeler

  • Promise<TabGroup[]>

    Chrome 90 ve üzeri sürümler

    Sözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türün aynısıyla çözülür.

update()

Promise 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

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

    • renk

      Renk isteğe bağlı

      Grubun rengi.

    • title

      dize isteğe bağlı

      Grubun başlığı.

  • callback

    işlev 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.

İadeler

  • Promise<TabGroup | undefined>

    Chrome 90 ve üzeri sürümler

    Sözler Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türün aynısıyla çözülür.

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 bir pencere içinde taşındığında tetiklenir. Taşıma etkinlikleri, gruptaki sekmeler ve grubun kendisi için tetiklenmeye devam eder. Bu etkinlik, bir grup pencereler arasında taşındığında tetiklenmez. Bunun yerine, grup 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