คำอธิบาย
ใช้ chrome.tabGroups API เพื่อโต้ตอบกับระบบการจัดกลุ่มแท็บของเบราว์เซอร์ คุณสามารถใช้ API นี้เพื่อแก้ไขและจัดเรียงกลุ่มแท็บในเบราว์เซอร์ใหม่ได้ หากต้องการจัดกลุ่มและยกเลิกการจัดกลุ่มแท็บ หรือค้นหาว่าแท็บใดอยู่ในกลุ่ม ให้ใช้ chrome.tabs API
สิทธิ์
tabGroupsความพร้อมใช้งาน
ประเภท
Color
สีของกลุ่ม
ค่าแจกแจง
"grey"
"blue"
"red"
"yellow"
"green"
"pink"
"purple"
"cyan"
"orange"
TabGroup
พร็อพเพอร์ตี้
-
ยุบแล้ว
บูลีน
กลุ่มยุบอยู่หรือไม่ กลุ่มที่ยุบคือกลุ่มที่ซ่อนแท็บไว้
-
สี
สีของกลุ่ม
-
id
ตัวเลข
รหัสของกลุ่ม รหัสกลุ่มจะไม่ซ้ำกันภายในเซสชันของเบราว์เซอร์
-
บูลีน
Chrome 137 ขึ้นไป browser.* ตั้งแต่ Chrome 148มีการแชร์กลุ่มหรือไม่
-
title
สตริง ไม่บังคับ
ชื่อของกลุ่ม
-
windowId
ตัวเลข
รหัสของหน้าต่างที่มีกลุ่ม
พร็อพเพอร์ตี้
TAB_GROUP_ID_NONE
รหัสที่แสดงถึงการไม่มีกลุ่ม
ค่า
-1
เมธอด
get()
browser.tabGroups.get(
groupId: number,
): Promise<TabGroup>
ดึงข้อมูลรายละเอียดเกี่ยวกับกลุ่มที่ระบุ
พารามิเตอร์
-
groupId
ตัวเลข
การคืนสินค้า
-
Promise<TabGroup>
Chrome 90 ขึ้นไป เบราว์เซอร์* ตั้งแต่ Chrome 148
move()
browser.tabGroups.move(
groupId: number,
moveProperties: object,
): Promise<TabGroup | undefined>
ย้ายกลุ่มและแท็บทั้งหมดภายในหน้าต่างของกลุ่มหรือไปยังหน้าต่างใหม่
พารามิเตอร์
-
groupId
ตัวเลข
รหัสของกลุ่มที่จะย้าย
-
moveProperties
ออบเจ็กต์
-
ดัชนี
ตัวเลข
ตำแหน่งที่จะย้ายกลุ่มไป ใช้
-1เพื่อวางกลุ่มที่ส่วนท้ายของหน้าต่าง -
windowId
number ไม่บังคับ
หน้าต่างที่จะย้ายกลุ่มไป ค่าเริ่มต้นคือหน้าต่างที่กลุ่มนั้นอยู่ โปรดทราบว่าคุณจะย้ายกลุ่มไปยังและจากหน้าต่างที่มีประเภท
windows.WindowTypeเป็น"normal"ได้เท่านั้น
-
การคืนสินค้า
-
Promise<TabGroup | undefined>
Chrome 90 ขึ้นไป เบราว์เซอร์* ตั้งแต่ Chrome 148
query()
browser.tabGroups.query(
queryInfo: object,
): Promise<TabGroup[]>
รับกลุ่มทั้งหมดที่มีพร็อพเพอร์ตี้ที่ระบุ หรือกลุ่มทั้งหมดหากไม่ได้ระบุพร็อพเพอร์ตี้
พารามิเตอร์
-
queryInfo
ออบเจ็กต์
-
ยุบแล้ว
บูลีน ไม่บังคับ
กลุ่มยุบอยู่หรือไม่
-
สี
สี ไม่บังคับ
สีของกลุ่ม
-
บูลีน ไม่บังคับ
Chrome 137 ขึ้นไป browser.* ตั้งแต่ Chrome 148มีการแชร์กลุ่มหรือไม่
-
title
สตริง ไม่บังคับ
จับคู่ชื่อกลุ่มกับรูปแบบ
-
windowId
number ไม่บังคับ
รหัสของหน้าต่างหลัก หรือ
windows.WINDOW_ID_CURRENTสำหรับหน้าต่างปัจจุบัน
-
การคืนสินค้า
-
Promise<TabGroup[]>
Chrome 90 ขึ้นไป เบราว์เซอร์* ตั้งแต่ Chrome 148
update()
browser.tabGroups.update(
groupId: number,
updateProperties: object,
): Promise<TabGroup | undefined>
แก้ไขพร็อพเพอร์ตี้ของกลุ่ม ระบบจะไม่แก้ไขพร็อพเพอร์ตี้ที่ไม่ได้ระบุไว้ใน updateProperties
พารามิเตอร์
-
groupId
ตัวเลข
รหัสของกลุ่มที่จะแก้ไข
-
updateProperties
ออบเจ็กต์
-
ยุบแล้ว
บูลีน ไม่บังคับ
ควรยุบกลุ่มหรือไม่
-
สี
สี ไม่บังคับ
สีของกลุ่ม
-
title
สตริง ไม่บังคับ
ชื่อของกลุ่ม
-
การคืนสินค้า
-
Promise<TabGroup | undefined>
Chrome 90 ขึ้นไป เบราว์เซอร์* ตั้งแต่ Chrome 148
กิจกรรม
onCreated
browser.tabGroups.onCreated.addListener(
callback: function,
)
เริ่มทำงานเมื่อมีการสร้างกลุ่ม
พารามิเตอร์
-
callback
ฟังก์ชัน
พารามิเตอร์
callbackจะมีลักษณะดังนี้(group: TabGroup) => void
-
กลุ่ม
-
onMoved
browser.tabGroups.onMoved.addListener(
callback: function,
)
เริ่มทำงานเมื่อมีการย้ายกลุ่มภายในหน้าต่าง ระบบจะยังคงเริ่มเหตุการณ์การย้ายสำหรับแต่ละแท็บภายในกลุ่ม รวมถึงสำหรับกลุ่มเองด้วย เหตุการณ์นี้จะไม่เริ่มทำงานเมื่อมีการย้ายกลุ่มระหว่างหน้าต่าง แต่ระบบจะนำกลุ่มออกจากหน้าต่างหนึ่งและสร้างในอีกหน้าต่างหนึ่งแทน
พารามิเตอร์
-
callback
ฟังก์ชัน
พารามิเตอร์
callbackจะมีลักษณะดังนี้(group: TabGroup) => void
-
กลุ่ม
-
onRemoved
browser.tabGroups.onRemoved.addListener(
callback: function,
)
เริ่มทำงานเมื่อปิดกลุ่ม ไม่ว่าจะโดยผู้ใช้โดยตรงหรือโดยอัตโนมัติเนื่องจากไม่มีแท็บ
พารามิเตอร์
-
callback
ฟังก์ชัน
พารามิเตอร์
callbackจะมีลักษณะดังนี้(group: TabGroup) => void
-
กลุ่ม
-
onUpdated
browser.tabGroups.onUpdated.addListener(
callback: function,
)
เริ่มทำงานเมื่อมีการอัปเดตกลุ่ม