chrome.tabGroups

คำอธิบาย

ใช้ chrome.tabGroups API เพื่อโต้ตอบกับระบบการจัดกลุ่มแท็บของเบราว์เซอร์ คุณจะใช้ API นี้เพื่อแก้ไขและจัดเรียงกลุ่มแท็บในเบราว์เซอร์ได้ หากต้องการจัดกลุ่มและยกเลิกการจัดกลุ่มแท็บ หรือค้นหาแท็บที่อยู่ในกลุ่ม ให้ใช้ chrome.tabs API

สิทธิ์

tabGroups

ความพร้อมใช้งาน

Chrome เวอร์ชัน 89 ขึ้นไป MV3 ขึ้นไป

ประเภท

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

  • กลุ่ม

    TabGroup

การคืนสินค้า

• 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 ไม่บังคับ

    รายละเอียดเกี่ยวกับกลุ่มที่ย้าย

การคืนสินค้า

• คำมั่นสัญญา<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 ไม่บังคับ

    รายละเอียดเกี่ยวกับกลุ่มที่อัปเดต

การคืนสินค้า

• คำมั่นสัญญา<TabGroup|undefined>

  Chrome 90 ขึ้นไป

  Manifest V3 ขึ้นไปรองรับคำสัญญา แต่จะใช้โค้ดเรียกกลับเพื่อความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 ฟีเจอร์ในการเรียกใช้ฟังก์ชันเดียวกันได้ คำสัญญาจะยุติด้วยประเภทเดียวกันกับที่ส่งไปยังโค้ดเรียกกลับ

กิจกรรม

onCreated

chrome.tabGroups.onCreated.addListener(
  callback: function,
)

เริ่มทำงานเมื่อมีการสร้างกลุ่ม

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback มีลักษณะดังนี้

  (group: TabGroup)=>void

  • กลุ่ม

    TabGroup

onMoved

chrome.tabGroups.onMoved.addListener(
  callback: function,
)

เริ่มทำงานเมื่อย้ายกลุ่มภายในหน้าต่าง เหตุการณ์การย้ายจะยังคงเริ่มทำงานสำหรับแต่ละแท็บภายในกลุ่ม รวมถึงสำหรับกลุ่มด้วย เหตุการณ์นี้จะไม่เริ่มทำงานเมื่อมีการย้ายกลุ่มระหว่างหน้าต่าง แต่จะถูกนำออกจากหน้าต่างหนึ่งและสร้างในอีกหน้าต่างหนึ่งแทน

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback มีลักษณะดังนี้

  (group: TabGroup)=>void

  • กลุ่ม

    TabGroup

onRemoved

chrome.tabGroups.onRemoved.addListener(
  callback: function,
)

เริ่มทำงานเมื่อกลุ่มถูกปิด ไม่ว่าจะโดยผู้ใช้โดยตรงหรือโดยอัตโนมัติเนื่องจากมีแท็บ 0 แท็บ

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback มีลักษณะดังนี้

  (group: TabGroup)=>void

  • กลุ่ม

    TabGroup

onUpdated

chrome.tabGroups.onUpdated.addListener(
  callback: function,
)

เริ่มทำงานเมื่อกลุ่มได้รับการอัปเดต

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback มีลักษณะดังนี้

  (group: TabGroup)=>void

  • กลุ่ม

    TabGroup