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, gruplandırmayı iptal etmek veya gruplarda hangi sekmelerin olduğunu sorgulamak için chrome.tabs API'yi kullanın.

İzinler

tabGroups

Kullanılabilirlik

Chrome 89 ve sonraki sürümler MV3 ve sonraki sürümler

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

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

Söz 
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

İlerlemeler

  • Promise<TabGroup>

    Chrome 90 ve sonraki sürümler

    Vaatler, 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()

Söz 
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

  • Söz<TabGroup|undefined>

    Chrome 90 ve sonraki sürümler

    Vaatler, 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()

Söz 
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

İlerlemeler

  • Promise<TabGroup[]>

    Chrome 90 ve sonraki sürümler

    Vaatler, 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()

Söz 
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

  • Söz<TabGroup|undefined>

    Chrome 90 ve sonraki sürümler

    Vaatler, 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

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

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

onUpdated

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

Bir grup güncellendiğinde tetiklenir.

Parametreler

  • geri çağırma

    işlev

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

    (group: TabGroup)=>void