chrome.tabGroups

Deskripsi

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

Izin

tabGroups

Ketersediaan

Chrome 89+ MV3+

Jenis

Color

Warna grup.

Enum

"abu-abu"

"biru"

"merah"

"kuning"

"hijau"

"pink"

"ungu"

"cyan"

"orange"

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.

  • dibagikan

    boolean

    Chrome 137+

    Apakah grup dibagikan.

  • judul

    string opsional

    Judul grup.

  • windowId

    angka

    ID jendela yang berisi grup.

Properti

TAB_GROUP_ID_NONE

ID yang menunjukkan tidak adanya grup.

Nilai

-1

Metode

get()

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

Mengambil detail tentang grup yang ditentukan.

Parameter

  • groupId

    angka

Hasil

move()

chrome.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 untuk memindahkan grup. Gunakan -1 untuk menempatkan grup di akhir jendela.

    • windowId

      nomor opsional

      Jendela tempat Anda ingin memindahkan grup. Secara default, grup berada di jendela tempat grup berada saat ini. Perhatikan bahwa grup hanya dapat dipindahkan ke dan dari jendela dengan jenis "normal" windows.WindowType.

Hasil

  • Promise<TabGroup | undefined>

    Chrome 90+

query()

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

Mendapatkan semua grup yang memiliki properti tertentu, 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+

      Apakah grup dibagikan.

    • judul

      string opsional

      Mencocokkan judul grup dengan pola.

    • windowId

      nomor opsional

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

Hasil

update()

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

Mengubah properti grup. Properti yang tidak ditentukan di updateProperties tidak 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+

Acara

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 dalam jendela. Peristiwa pemindahan masih diaktifkan untuk masing-masing tab dalam grup, serta untuk grup itu sendiri. Peristiwa ini tidak dipicu 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

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

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

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