chrome.tabGroups

Deskripsi

Gunakan chrome.tabGroups API untuk berinteraksi dengan sistem pengelompokan tab browser. Anda dapat menggunakan API ini untuk memodifikasi dan mengatur ulang grup tab di browser. Untuk mengelompokkan dan memisahkan tab, atau membuat kueri tab yang ada dalam grup, gunakan chrome.tabs API.

Izin

tabGroups

Ketersediaan

Chrome 89 dan yang lebih baru MV3 dan yang lebih baru

Jenis

Color

Warna grup.

Enum

"abu-abu"

"biru"

"merah"

"kuning"

"hijau"

"merah muda"

"ungu"

"sian"

"oranye"

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.

  • judul

    string opsional

    Judul grup.

  • windowId

    angka

    ID jendela yang berisi grup.

Properti

TAB_GROUP_ID_NONE

ID yang mewakili tidak adanya grup.

Nilai

-1

Metode

get()

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

Mengambil detail tentang grup yang ditentukan.

Parameter

  • groupId

    angka

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    (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. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

move()

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

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

Parameter

  • groupId

    angka

    ID grup yang akan dipindahkan.

  • moveProperties

    objek

    • indeks

      angka

      Posisi tujuan pemindahan grup. Gunakan -1 untuk menempatkan grup di akhir jendela.

    • windowId

      angka opsional

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

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    (group?: TabGroup) => void

    • grup

      TabGroup opsional

      Detail tentang grup yang dipindahkan.

Hasil

  • Promise<TabGroup | tidak terdefinisi>

    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. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

query()

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

    • judul

      string opsional

      Cocokkan judul grup dengan pola.

    • windowId

      angka opsional

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

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    (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. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

update()

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

Memodifikasi properti grup. Properti yang tidak ditetapkan di updateProperties tidak diubah.

Parameter

  • groupId

    angka

    ID grup yang akan diubah.

  • updateProperties

    objek

    • diciutkan

      boolean opsional

      Apakah grup harus diciutkan atau tidak.

    • warna

      Warna opsional

      Warna grup.

    • judul

      string opsional

      Judul grup.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    (group?: TabGroup) => void

    • grup

      TabGroup opsional

      Detail tentang grup yang diperbarui.

Hasil

  • Promise<TabGroup | tidak terdefinisi>

    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. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

Acara

onCreated

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

Diaktifkan saat grup dibuat.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

    (group: TabGroup) => void

onMoved

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

Diaktifkan saat grup dipindahkan di dalam jendela. Peristiwa pemindahan masih diaktifkan untuk masing-masing tab dalam grup, serta untuk grup itu sendiri. Peristiwa ini tidak diaktifkan saat grup dipindahkan antar-jendela; sebagai gantinya, data akan dihapus dari satu jendela dan dibuat di jendela yang lain.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

    (group: TabGroup) => void

onRemoved

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

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

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

    (group: TabGroup) => void

onUpdated

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

Diaktifkan saat grup diperbarui.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

    (group: TabGroup) => void