chrome.sessions

คำอธิบาย

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

สิทธิ์

sessions

ประเภท

Device

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

  • deviceName

    string

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

  • เซสชัน

    เซสชัน[]

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

Filter

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

  • maxResults

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

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

Session

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

  • lastModified

    ตัวเลข

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

  • Tab

    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

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

  • สัญญา<Device[]>

    Chrome 96 ขึ้นไป

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

getRecentlyClosed()

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

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

พารามิเตอร์

  • ฟิลเตอร์

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

  • Callback

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

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

    (sessions: Session[])=>void

    • เซสชัน

      เซสชัน[]

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

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

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

    Chrome 96 ขึ้นไป

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

restore()

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

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

พารามิเตอร์

  • sessionId

    string ไม่บังคับ

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

  • Callback

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

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

    (restoredSession: Session)=>void

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

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

    Chrome 96 ขึ้นไป

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

กิจกรรม

onChanged

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    ()=>void