chrome.tabGroups

Deskripsi

Menggunakan chrome.tabGroups API untuk berinteraksi dengan sistem pengelompokan tab browser. Anda dapat menggunakan API ini untuk mengubah dan mengatur ulang grup tab di browser. Untuk mengelompokkan dan membatalkan pengelompokan tab, atau untuk mengkueri tab apa saja yang ada dalam grup, gunakan chrome.tabs API.

Izin

tabGroups

Ketersediaan

Chrome 89+ MV3+

Jenis

Color

Warna grup.

Enum

"cyan"

TabGroup

Properti

  • diciutkan

    boolean

    Apakah grup diciutkan. Grup yang diciutkan adalah grup yang tabnya disembunyikan.

  • warna

    Warna

    Warna grup.

  • id

    angka

    ID grup. ID grup bersifat unik dalam sesi browser.

  • title

    string opsional

    Judul grup.

  • windowId

    angka

    ID jendela yang berisi grup.

Properti

TAB_GROUP_ID_NONE

ID yang merepresentasikan tidak adanya grup.

Nilai

-1

Metode

get()

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

Mengambil detail tentang grup yang ditentukan.

Parameter

  • groupId

    angka

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (group: TabGroup)=>void

Hasil

  • Promise<TabGroup>

    Chrome 90 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

move()

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

Memindahkan grup dan semua tabnya di dalam jendela, atau ke jendela baru.

Parameter

  • groupId

    angka

    ID grup yang akan dipindahkan.

  • moveProperties

    objek

    • index

      angka

      Posisi untuk memindahkan grup. Gunakan -1 untuk menempatkan grup di akhir jendela.

    • windowId

      nomor opsional

      Jendela untuk memindahkan grup. Setelan defaultnya adalah jendela tempat grup berada saat ini. Perhatikan bahwa grup hanya dapat dipindahkan ke dan dari jendela dengan jenis windows.WindowType "normal".

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (group?: TabGroup)=>void

    • grup

      TabGroup opsional

      Detail tentang grup yang dipindahkan.

Hasil

  • Promise<TabGroup|undefined>

    Chrome 90 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

query()

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

Mendapatkan semua grup yang memiliki properti yang ditentukan, atau semua grup jika tidak ada properti yang ditentukan.

Parameter

  • queryInfo

    objek

    • diciutkan

      boolean opsional

      Apakah grup diciutkan.

    • warna

      Warna opsional

      Warna grup.

    • title

      string opsional

      Mencocokkan judul grup dengan pola.

    • windowId

      nomor opsional

      ID jendela induk, atau windows.WINDOW_ID_CURRENT untuk jendela saat ini.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (result: TabGroup[])=>void

Hasil

  • Promise<TabGroup[]>

    Chrome 90 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

update()

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

Memodifikasi properti suatu kelompok. Properti yang tidak ditentukan di updateProperties tidak akan diubah.

Parameter

  • groupId

    angka

    ID grup yang akan diubah.

  • updateProperties

    objek

    • diciutkan

      boolean opsional

      Apakah grup harus diciutkan.

    • warna

      Warna opsional

      Warna grup.

    • title

      string opsional

      Judul grup.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (group?: TabGroup)=>void

    • grup

      TabGroup opsional

      Detail tentang grup yang diperbarui.

Hasil

  • Promise<TabGroup|undefined>

    Chrome 90 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

Peristiwa

onCreated

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

Diaktifkan saat grup dibuat.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (group: TabGroup)=>void

onMoved

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

Diaktifkan saat grup dipindahkan di dalam jendela. Peristiwa pemindahan tetap diaktifkan untuk setiap tab dalam grup, dan untuk grup itu sendiri. Peristiwa ini tidak diaktifkan saat grup dipindahkan antar-jendela; sebagai gantinya, peristiwa akan dihapus dari satu jendela dan dibuat di jendela lain.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (group: TabGroup)=>void

onRemoved

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

Diaktifkan saat grup ditutup, baik secara langsung oleh pengguna maupun secara otomatis karena tidak berisi tab apa pun.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (group: TabGroup)=>void

onUpdated

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

Diaktifkan saat grup diperbarui.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (group: TabGroup)=>void