chrome.tabGroups

คำอธิบาย

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

สิทธิ์

tabGroups

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

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

ประเภท

Color

สีของกลุ่ม

ค่าแจกแจง

"เทา"

"น้ำเงิน"

"แดง"

"เหลือง"

"green"

"ชมพู"

"สีม่วง"

"ฟ้า"

"ส้ม"

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>

    Chrome 90 ขึ้นไป

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

move()

สัญญา 
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

ย้ายกลุ่มและแท็บทั้งหมดภายในหน้าต่างหรือไปยังหน้าต่างใหม่

พารามิเตอร์

  • groupId

    ตัวเลข

    รหัสของกลุ่มที่จะย้าย

  • moveProperties

    ออบเจ็กต์

    • ดัชนี

      ตัวเลข

      ตำแหน่งที่จะย้ายกลุ่มไป ใช้ -1 เพื่อวางกลุ่มไว้ที่ส่วนท้ายของหน้าต่าง

    • windowId

      หมายเลข ไม่บังคับ

      หน้าต่างที่จะย้ายกลุ่มไป ค่าเริ่มต้นจะเป็นหน้าต่างที่กลุ่มอยู่ในปัจจุบัน โปรดทราบว่าคุณจะย้ายกลุ่มเข้าและออกจากหน้าต่างที่มี windows.WindowType ประเภท "normal" ได้เท่านั้น

  • Callback

    ไม่บังคับ

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

    (group?: TabGroup) => void

    • กลุ่ม

      TabGroup ไม่บังคับ

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

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

  • สัญญา<TabGroup | ไม่ระบุ>

    Chrome 90 ขึ้นไป

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

query()

สัญญา 
chrome.tabGroups.query(
  queryInfo: object,
  callback?: function,
)

รับกลุ่มทั้งหมดที่มีพร็อพเพอร์ตี้ที่ระบุ หรือทุกกลุ่มหากไม่ได้ระบุพร็อพเพอร์ตี้

พารามิเตอร์

  • queryInfo

    ออบเจ็กต์

    • ยุบแล้ว

      บูลีน ไม่บังคับ

      ยุบกลุ่มหรือไม่

    • สี

      สี ไม่บังคับ

      สีของกลุ่ม

    • title

      string ไม่บังคับ

      จับคู่ชื่อกลุ่มกับรูปแบบ

    • windowId

      หมายเลข ไม่บังคับ

      รหัสของหน้าต่างระดับบนสุดหรือ windows.WINDOW_ID_CURRENT ของหน้าต่างปัจจุบัน

  • Callback

    ไม่บังคับ

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

    (result: TabGroup[]) => void

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

  • สัญญา<TabGroup[]>

    Chrome 90 ขึ้นไป

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

update()

สัญญา 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

แก้ไขพร็อพเพอร์ตี้ของกลุ่ม ระบบจะไม่แก้ไขพร็อพเพอร์ตี้ที่ไม่ได้ระบุใน updateProperties

พารามิเตอร์

  • groupId

    ตัวเลข

    รหัสของกลุ่มที่จะแก้ไข

  • updateProperties

    ออบเจ็กต์

    • ยุบแล้ว

      บูลีน ไม่บังคับ

      ควรยุบกลุ่มไหม

    • สี

      สี ไม่บังคับ

      สีของกลุ่ม

    • title

      string ไม่บังคับ

      ชื่อกลุ่ม

  • Callback

    ไม่บังคับ

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

    (group?: TabGroup) => void

    • กลุ่ม

      TabGroup ไม่บังคับ

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

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

  • สัญญา<TabGroup | ไม่ระบุ>

    Chrome 90 ขึ้นไป

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

กิจกรรม

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,
)

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (group: TabGroup) => void