chrome.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 membatalkan pengelompokan tab, atau membuat kueri tab yang ada dalam grup, gunakan chrome.tabs API.

Izin

tabGroups

Ketersediaan

Chrome 89+ MV3+

Jenis

Color

Warna grup.

Enum

"grey"

"blue"

"red"

"yellow"

"hijau"

"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

    Tertunda

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

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+

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

      number opsional

      Jendela tempat grup akan dipindahkan. Secara default, jendela yang saat ini digunakan grup. 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+

    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.

    • dibagikan

      boolean opsional

      Tertunda

      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.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (result: TabGroup[]) => void

Hasil

  • Promise<TabGroup[]>

    Chrome 90+

    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,
)

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.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (group?: TabGroup) => void

    • grup

      TabGroup opsional

      Detail tentang grup yang diperbarui.

Hasil

  • Promise<TabGroup | undefined>

    Chrome 90+

    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.

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 setiap tab dalam grup, serta untuk grup itu sendiri. Peristiwa ini tidak diaktifkan saat grup dipindahkan antar-jendela; sebagai gantinya, peristiwa ini 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.

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