browser.sessions

คำอธิบาย

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

สิทธิ์

sessions

ประเภท

Device

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

  • deviceName

    สตริง

    ชื่อของอุปกรณ์ภายนอก

  • เซสชัน

    เซสชัน[]

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

Filter

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

  • maxResults

    number ไม่บังคับ

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

Session

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

  • lastModified

    ตัวเลข

    เวลาที่ปิดหรือแก้ไขหน้าต่างหรือแท็บ โดยแสดงเป็นวินาทีนับตั้งแต่ Epoch

  • แท็บ

    Tab ไม่บังคับ

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

  • หน้าต่าง

    Window ไม่บังคับ

    windows.Window หากรายการนี้อธิบายหน้าต่าง ระบบจะตั้งค่าฟิลด์นี้หรือ sessions.Session.tab

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

MAX_SESSION_RESULTS

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

ค่า

25

เมธอด

getDevices()

browser.sessions.getDevices(
  filter?: Filter,
): Promise<Device[]>

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

พารามิเตอร์

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

  • Promise<Device[]>

    Chrome 96 ขึ้นไป browser.* ตั้งแต่ Chrome 148

getRecentlyClosed()

browser.sessions.getRecentlyClosed(
  filter?: Filter,
): Promise<Session[]>

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

พารามิเตอร์

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

  • Promise<Session[]>

    Chrome 96 ขึ้นไป browser.* ตั้งแต่ Chrome 148

restore()

browser.sessions.restore(
  sessionId?: string,
): Promise<Session>

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

พารามิเตอร์

  • sessionId

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

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

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

  • Promise<Session>

    Chrome 96 ขึ้นไป browser.* ตั้งแต่ Chrome 148

กิจกรรม

onChanged

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

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

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    () => void