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
Jenis
Color
Warna grup.
Enum
"cyan"
TabGroup
Properti
-
diciutkan
boolean
Apakah grup diciutkan. Grup yang diciutkan adalah grup yang tabnya disembunyikan.
-
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()
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
-
grup
-
Hasil
-
Promise<TabGroup>
Chrome 90 dan yang lebih baruPromise 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()
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 baruPromise 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()
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
TabGroup[]
-
Hasil
-
Promise<TabGroup[]>
Chrome 90 dan yang lebih baruPromise 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()
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 baruPromise 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
-
grup
-
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
-
grup
-
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
-
grup
-
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
Diaktifkan saat grup diperbarui.