คำอธิบาย
ใช้ 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 ขึ้นไปPromiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
รับรายการแท็บและ/หรือหน้าต่างที่เพิ่งปิด
พารามิเตอร์
การคืนสินค้า
-
สัญญา<เซสชัน[]>
Chrome 96 ขึ้นไปPromiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ
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
-
restoredSession
sessions.Session
มีออบเจ็กต์windows.Window
หรือtabs.Tab
ที่กู้คืน
-
การคืนสินค้า
-
สัญญา<เซสชัน>
Chrome 96 ขึ้นไปPromiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ
กิจกรรม
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
เริ่มทำงานเมื่อแท็บและ/หรือหน้าต่างที่ปิดล่าสุดมีการเปลี่ยนแปลง เหตุการณ์นี้ไม่ได้ตรวจสอบการเปลี่ยนแปลงเซสชันที่ซิงค์
พารามิเตอร์
-
Callback
ฟังก์ชัน
พารามิเตอร์
callback
มีลักษณะดังนี้() => void