chrome.tabGroups

Açıklama

Tarayıcının sekme gruplama sistemiyle etkileşimde bulunmak için chrome.tabGroups API'sini kullanın. Bu API'yi, tarayıcıdaki sekme gruplarını değiştirmek ve yeniden düzenlemek için kullanabilirsiniz. Sekmeleri gruplandırıp gruplandırmak veya gruplarda hangi sekmelerin bulunduğunu sorgulamak için chrome.tabs API'yi kullanın.

İzinler

tabGroups

Kullanılabilirlik

Chrome 89 ve sonraki sürümler MV3+

Türler

Color

Grubun rengi.

Enum

"gri"

"mavi"

"kırmızı"

"sarı"

"green"

"pembe"

"mor"

"camgöbeği"

"turuncu"

TabGroup

Özellikler

  • daraltıldı

    boolean

    Grubun daraltılıp daraltılmadığı. Daraltılmış grup, sekmeleri gizli olan gruplardır.

  • renk

    Renk

    Grubun rengi.

  • id

    sayı

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

  • 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ı temsil eden kimlik.

Değer

-1

Yöntemler

get()

Söz 'nı inceleyin.
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

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

Parametreler

  • groupId

    sayı

  • geri çağırma

    işlev isteğe bağlı

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

    (group: TabGroup) => void

İadeler

  • Promise<TabGroup>

    Chrome 90 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

move()

Söz 'nı inceleyin.
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

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şunu kullanın.

    • windowId

      sayı isteğe bağlı

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

  • geri çağırma

    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 | tanımlanmadı>

    Chrome 90 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

query()

Söz 'nı inceleyin.
chrome.tabGroups.query(
  queryInfo: object,
  callback?: function,
)

Belirtilen özelliklere sahip tüm grupları veya hiçbir özellik belirtilmezse 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.

    • title

      dize isteğe bağlı

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

    • windowId

      sayı isteğe bağlı

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

  • geri çağırma

    işlev isteğe bağlı

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

    (result: TabGroup[]) => void

İadeler

  • Söz veriyorum<TabGroup[]>

    Chrome 90 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

update()

Söz 'nı inceleyin.
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ığı.

  • geri çağırma

    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 | tanımlanmadı>

    Chrome 90 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

Etkinlikler

onCreated

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

Bir 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, hem gruptaki tek tek sekmeler hem de grubun kendisi için tetiklenmeye devam eder. 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 hiç 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