chrome.sessions

คำอธิบาย

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

สิทธิ์

sessions

ประเภท

Device

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

  • deviceName

    สตริง

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

  • เซสชัน

    เซสชัน[]

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

Filter

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

  • ผลลัพธ์สูงสุด

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

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

Session

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

  • lastModified

    ตัวเลข

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

  • แท็บ

    Tab ไม่บังคับ

    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

    • อุปกรณ์

      อุปกรณ์[]

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

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

  • สัญญา<อุปกรณ์[]>

    Chrome 96 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

getRecentlyClosed()

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

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

พารามิเตอร์

  • ตัวกรอง

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

  • Callback

    ไม่บังคับ

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

    (sessions: Session[]) => void

    • เซสชัน

      เซสชัน[]

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

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

  • สัญญา<เซสชัน[]>

    Chrome 96 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

restore()

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

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

พารามิเตอร์

  • sessionId

    string ไม่บังคับ

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

  • Callback

    ไม่บังคับ

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

    (restoredSession: Session) => void

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

  • Promise&lt;Session&gt;

    Chrome 96 ขึ้นไป

    Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

กิจกรรม

onChanged

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    () => void