chrome.sessions

คำอธิบาย

ใช้ chrome.sessions API เพื่อค้นหาและกู้คืนแท็บและหน้าต่างจากเซสชันการท่องเว็บ

สิทธิ์

sessions

ประเภท

Device

พร็อพเพอร์ตี้

  • deviceName

    สตริง

    ชื่อของอุปกรณ์ต่างประเทศ

  • เซสชัน

    Session[]

    รายการเซสชันหน้าต่างที่เปิดอยู่ของอุปกรณ์ภายนอก โดยจัดเรียงจากเซสชันที่แก้ไขล่าสุดไปจนถึงเซสชันที่แก้ไขล่าสุดน้อยที่สุด

Filter

พร็อพเพอร์ตี้

  • maxResults

    ตัวเลข ไม่บังคับ

    จำนวนรายการสูงสุดที่จะดึงข้อมูลในรายการที่ขอ ละเว้นพารามิเตอร์นี้เพื่อดึงข้อมูลรายการจำนวนสูงสุด (sessions.MAX_SESSION_RESULTS)

Session

พร็อพเพอร์ตี้

  • lastModified

    ตัวเลข

    เวลาที่มีการปิดหรือแก้ไขหน้าต่างหรือแท็บ ซึ่งแสดงเป็นวินาทีนับจากจุดเริ่มต้น

  • แท็บ

    แท็บ ไม่บังคับ

    tabs.Tab หากรายการนี้อธิบายแท็บ ระบบจะตั้งค่าเป็นค่านี้หรือ sessions.Session.window

  • หน้าต่าง

    กรอบเวลา ไม่บังคับ

    windows.Window หากรายการนี้อธิบายถึงกรอบเวลา ระบบจะตั้งค่าเป็นค่านี้หรือ sessions.Session.tab

พร็อพเพอร์ตี้

MAX_SESSION_RESULTS

จำนวน sessions.Session สูงสุดที่จะรวมอยู่ในรายการที่ขอ

ค่า

25

เมธอด

getDevices()

สัญญา 
chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
)

ดึงข้อมูลอุปกรณ์ทั้งหมดที่มีเซสชันที่ซิงค์

พารามิเตอร์

  • ตัวกรอง

    ตัวกรอง ไม่บังคับ

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (devices: Device[]) => void

    • อุปกรณ์

      Device[]

      รายการออบเจ็กต์ sessions.Device สำหรับเซสชันที่ซิงค์แต่ละรายการ โดยจัดเรียงจากอุปกรณ์ที่มีเซสชันที่แก้ไขล่าสุดไปจนถึงอุปกรณ์ที่มีเซสชันที่แก้ไขล่าสุดน้อยที่สุด ระบบจะจัดเรียงออบเจ็กต์ tabs.Tab ตามลำดับล่าสุดใน windows.Window ของออบเจ็กต์ sessions.Session

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

  • Promise<Device[]>

    Chrome 96 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getRecentlyClosed()

สัญญา 
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

รับรายการแท็บและ/หรือหน้าต่างที่เพิ่งปิด

พารามิเตอร์

  • ตัวกรอง

    ตัวกรอง ไม่บังคับ

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (sessions: Session[]) => void

    • เซสชัน

      Session[]

      รายการรายการที่ปิดตามลำดับย้อนกลับ (แท็บหรือหน้าต่างที่ปิดล่าสุดจะอยู่อยู่ที่ดัชนี 0) รายการดังกล่าวอาจมีแท็บหรือหน้าต่าง

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

  • Promise<Session[]>

    Chrome 96 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

restore()

สัญญา 
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

เปิด windows.Window หรือ tabs.Tab อีกครั้ง โดยมีตัวเลือกให้เรียกใช้การเรียกกลับเมื่อมีการกู้คืนรายการแล้ว

พารามิเตอร์

  • sessionId

    สตริง ไม่บังคับ

    windows.Window.sessionId หรือ tabs.Tab.sessionId เพื่อกู้คืน หากไม่ได้ระบุพารามิเตอร์นี้ ระบบจะกู้คืนเซสชันที่ปิดล่าสุด

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (restoredSession: Session) => void

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

  • Promise<Session>

    Chrome 96 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

กิจกรรม

onChanged

chrome.sessions.onChanged.addListener(
  callback: function,
)

เรียกใช้เมื่อมีการเปลี่ยนแปลงแท็บและ/หรือหน้าต่างที่เพิ่งปิด เหตุการณ์นี้จะไม่ตรวจสอบการเปลี่ยนแปลงเซสชันที่ซิงค์

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    () => void