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