browser.tabGroups

Deskripsi

Gunakan 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 memisahkan tab, atau untuk mengkueri tab apa yang ada dalam grup, gunakan chrome.tabs API.

Izin

tabGroups

Ketersediaan

Chrome 89+ browser.* sejak Chrome 148 MV3+

Jenis

Color

Warna grup.

Enum

"grey"

"blue"

"red"

"kuning"

"green"

"pink"

"purple"

"cyan"

"orange"

TabGroup

Properti

  • diciutkan

    boolean

    Apakah grup diciutkan. Grup yang diciutkan adalah grup yang tab-nya disembunyikan.

  • warna

    Warna

    Warna grup.

  • id

    angka

    ID grup. ID grup bersifat unik dalam sesi browser.

  • dibagikan

    boolean

    Chrome 137+ browser.* sejak Chrome 148

    Apakah grup dibagikan.

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

browser.tabGroups.get(
  groupId: number,
): Promise<TabGroup>

Mengambil detail tentang grup yang ditentukan.

Parameter

  • groupId

    angka

Hasil

  • Promise<TabGroup>

    Chrome 90+ browser.* sejak Chrome 148

move()

browser.tabGroups.move(
  groupId: number,
  moveProperties: object,
): Promise<TabGroup | undefined>

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

      number opsional

      Jendela tempat grup akan dipindahkan. Defaultnya adalah jendela tempat grup saat ini berada. Perhatikan bahwa grup hanya dapat dipindahkan ke dan dari jendela dengan jenis "normal" windows.WindowType.

Hasil

  • Promise<TabGroup | undefined>

    Chrome 90+ browser.* sejak Chrome 148

query()

browser.tabGroups.query(
  queryInfo: object,
): Promise<TabGroup[]>

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.

    • dibagikan

      boolean opsional

      Chrome 137+ browser.* sejak Chrome 148

      Apakah grup dibagikan.

    • judul

      string opsional

      Mencocokkan judul grup dengan pola.

    • windowId

      number opsional

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

Hasil

  • Promise<TabGroup[]>

    Chrome 90+ browser.* sejak Chrome 148

update()

browser.tabGroups.update(
  groupId: number,
  updateProperties: object,
): Promise<TabGroup | undefined>

Mengubah properti grup. 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.

    • judul

      string opsional

      Judul grup.

Hasil

  • Promise<TabGroup | undefined>

    Chrome 90+ browser.* sejak Chrome 148

Acara

onCreated

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

Diaktifkan saat grup dibuat.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (group: TabGroup) => void

onMoved

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

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

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (group: TabGroup) => void

onRemoved

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

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

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (group: TabGroup) => void

onUpdated

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

Diaktifkan saat grup diperbarui.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (group: TabGroup) => void