chrome.sessions

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

ใช้ 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()

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

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

พารามิเตอร์

  • ตัวกรอง

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

  • callback

    function ไม่บังคับ

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

    (devices: Device[]) => void

    • อุปกรณ์

      อุปกรณ์[]

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

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

  • Promise<Device[]>

    Chrome 96 ขึ้นไป

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

getRecentlyClosed()

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

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

พารามิเตอร์

  • ตัวกรอง

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

  • callback

    function ไม่บังคับ

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

    (sessions: Session[]) => void

    • เซสชัน

      เซสชัน[]

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

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

  • Promise<Session[]>

    Chrome 96 ขึ้นไป

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

restore()

Promise 
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
): Promise<Session>

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

พารามิเตอร์

  • sessionId

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

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

  • callback

    function ไม่บังคับ

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

    (restoredSession: Session) => void

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

  • Promise<Session>

    Chrome 96 ขึ้นไป

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

กิจกรรม

onChanged

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

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

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    () => void