คำอธิบาย
ใช้ chrome.tabGroups
API เพื่อโต้ตอบกับระบบการจัดกลุ่มแท็บของเบราว์เซอร์ คุณจะใช้ API นี้เพื่อแก้ไขและจัดเรียงกลุ่มแท็บในเบราว์เซอร์ได้ หากต้องการจัดกลุ่มและยกเลิกการจัดกลุ่มแท็บ หรือค้นหาแท็บที่อยู่ในกลุ่ม ให้ใช้ chrome.tabs
API
สิทธิ์
tabGroups
ความพร้อมใช้งาน
ประเภท
Color
สีของกลุ่ม
ค่าแจกแจง
TabGroup
พร็อพเพอร์ตี้
-
ยุบแล้ว
boolean
ยุบกลุ่มแล้วหรือไม่ กลุ่มที่ยุบคือกลุ่มที่ซ่อนแท็บไว้
-
สี
สีของกลุ่ม
-
id
ตัวเลข
รหัสของกลุ่ม รหัสกลุ่มจะไม่ซ้ำกันภายในเซสชันของเบราว์เซอร์
-
title
string ไม่บังคับ
ชื่อกลุ่ม
-
windowId
ตัวเลข
รหัสของหน้าต่างที่มีกลุ่ม
พร็อพเพอร์ตี้
TAB_GROUP_ID_NONE
รหัสที่แสดงถึงการไม่มีกลุ่ม
ค่า
-1
วิธีการ
get()
chrome.tabGroups.get(
groupId: number,
callback?: function,
)
เรียกข้อมูลรายละเอียดเกี่ยวกับกลุ่มที่ระบุ
พารามิเตอร์
-
groupId
ตัวเลข
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(group: TabGroup) => void
-
กลุ่ม
-
การคืนสินค้า
-
Promise<TabGroup>
Chrome 90 ขึ้นไปManifest V3 ขึ้นไปรองรับคำสัญญา แต่จะใช้โค้ดเรียกกลับเพื่อความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 ฟีเจอร์ในการเรียกใช้ฟังก์ชันเดียวกันได้ คำสัญญาจะยุติด้วยประเภทเดียวกันกับที่ส่งไปยังโค้ดเรียกกลับ
move()
chrome.tabGroups.move(
groupId: number,
moveProperties: object,
callback?: function,
)
ย้ายกลุ่มและแท็บทั้งหมดภายในหน้าต่างหรือไปยังหน้าต่างใหม่
พารามิเตอร์
-
groupId
ตัวเลข
รหัสของกลุ่มที่จะย้าย
-
moveProperties
ออบเจ็กต์
-
ดัชนี
ตัวเลข
ตำแหน่งที่ต้องการย้ายกลุ่มไป ใช้
-1
เพื่อวางกลุ่มไว้ที่ท้ายหน้าต่าง -
windowId
ตัวเลข ไม่บังคับ
หน้าต่างสำหรับย้ายกลุ่มไป ค่าเริ่มต้นจะเป็นหน้าต่างที่กลุ่มกำลังใช้งานอยู่ โปรดทราบว่าคุณย้ายกลุ่มเข้าและออกจากหน้าต่างที่มี
windows.WindowType
ประเภท"normal"
ได้เท่านั้น
-
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(group?: TabGroup) => void
-
กลุ่ม
TabGroup ไม่บังคับ
รายละเอียดเกี่ยวกับกลุ่มที่ย้าย
-
การคืนสินค้า
-
Promise<TabGroup | undefined>
Chrome 90 ขึ้นไปManifest V3 ขึ้นไปรองรับคำสัญญา แต่จะใช้โค้ดเรียกกลับเพื่อความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 ฟีเจอร์ในการเรียกใช้ฟังก์ชันเดียวกันได้ คำสัญญาจะยุติด้วยประเภทเดียวกันกับที่ส่งไปยังโค้ดเรียกกลับ
query()
chrome.tabGroups.query(
queryInfo: object,
callback?: function,
)
รับกลุ่มทั้งหมดที่มีพร็อพเพอร์ตี้ที่ระบุ หรือรับกลุ่มทั้งหมดหากไม่ได้ระบุพร็อพเพอร์ตี้
พารามิเตอร์
-
queryInfo
ออบเจ็กต์
-
ยุบแล้ว
บูลีน ไม่บังคับ
ยุบกลุ่มแล้วหรือไม่
-
สี
สี ไม่บังคับ
สีของกลุ่ม
-
title
string ไม่บังคับ
จับคู่ชื่อกลุ่มกับรูปแบบ
-
windowId
ตัวเลข ไม่บังคับ
รหัสของหน้าต่างระดับบนสุด หรือ
windows.WINDOW_ID_CURRENT
สำหรับหน้าต่างปัจจุบัน
-
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(result: TabGroup[]) => void
-
ผลลัพธ์
TabGroup[]
-
การคืนสินค้า
-
Promise<TabGroup[]>
Chrome 90 ขึ้นไปManifest V3 ขึ้นไปรองรับคำสัญญา แต่จะใช้โค้ดเรียกกลับเพื่อความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 ฟีเจอร์ในการเรียกใช้ฟังก์ชันเดียวกันได้ คำสัญญาจะยุติด้วยประเภทเดียวกันกับที่ส่งไปยังโค้ดเรียกกลับ
update()
chrome.tabGroups.update(
groupId: number,
updateProperties: object,
callback?: function,
)
แก้ไขคุณสมบัติของกลุ่ม ระบบจะไม่แก้ไขที่พักที่ไม่ได้ระบุไว้ใน updateProperties
พารามิเตอร์
-
groupId
ตัวเลข
รหัสของกลุ่มที่จะแก้ไข
-
updateProperties
ออบเจ็กต์
-
ยุบแล้ว
บูลีน ไม่บังคับ
ควรยุบกลุ่มหรือไม่
-
สี
สี ไม่บังคับ
สีของกลุ่ม
-
title
string ไม่บังคับ
ชื่อกลุ่ม
-
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(group?: TabGroup) => void
-
กลุ่ม
TabGroup ไม่บังคับ
รายละเอียดเกี่ยวกับกลุ่มที่อัปเดต
-
การคืนสินค้า
-
Promise<TabGroup | undefined>
Chrome 90 ขึ้นไปManifest V3 ขึ้นไปรองรับคำสัญญา แต่จะใช้โค้ดเรียกกลับเพื่อความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 ฟีเจอร์ในการเรียกใช้ฟังก์ชันเดียวกันได้ คำสัญญาจะยุติด้วยประเภทเดียวกันกับที่ส่งไปยังโค้ดเรียกกลับ
เหตุการณ์
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,
)
เริ่มทำงานเมื่อกลุ่มถูกปิด ไม่ว่าจะโดยผู้ใช้โดยตรงหรือโดยอัตโนมัติเนื่องจากมีแท็บ 0 แท็บ
พารามิเตอร์
-
Callback
ฟังก์ชัน
พารามิเตอร์
callback
มีลักษณะดังนี้(group: TabGroup) => void
-
กลุ่ม
-
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
เริ่มทำงานเมื่อกลุ่มได้รับการอัปเดต