Mô tả
Sử dụng API chrome.sessions
để truy vấn và khôi phục các thẻ và cửa sổ từ một phiên duyệt web.
Quyền
sessions
Loại
Device
Thuộc tính
-
deviceName
chuỗi
Tên của thiết bị nước ngoài.
-
phiên
Phiên[]
Danh sách các phiên cửa sổ đang mở cho thiết bị lạ, được sắp xếp từ phiên gần đây nhất đến phiên được sửa đổi gần đây nhất.
Filter
Thuộc tính
-
maxResults
số không bắt buộc
Số mục nhập tối đa cần tìm nạp trong danh sách được yêu cầu. Bỏ qua thông số này để tìm nạp số mục nhập tối đa (
sessions.MAX_SESSION_RESULTS
).
Session
Thuộc tính
-
lastModified
số
Thời gian cửa sổ hoặc thẻ được đóng hoặc sửa đổi, được biểu thị bằng giây kể từ thời gian bắt đầu hệ thống.
-
phím tab
Tab không bắt buộc
tabs.Tab
, nếu mục này mô tả một thẻ. Giá trị này hoặcsessions.Session.window
sẽ được đặt. -
cửa sổ
Cửa sổ không bắt buộc
windows.Window
, nếu mục này mô tả một cửa sổ. Giá trị này hoặcsessions.Session.tab
sẽ được đặt.
Thuộc tính
MAX_SESSION_RESULTS
Số lượng sessions.Session
tối đa sẽ có trong danh sách được yêu cầu.
Giá trị
25
Phương thức
getDevices()
chrome.sessions.getDevices(
filter?: Filter,
callback?: function,
)
Truy xuất tất cả thiết bị có phiên hoạt động được đồng bộ hoá.
Thông số
-
filter
Bộ lọc không bắt buộc
-
callback
hàm không bắt buộc
Tham số
callback
có dạng như sau:(devices: Device[]) => void
-
thiết bị
Thiết bị[]
Danh sách các đối tượng
sessions.Device
cho mỗi phiên đã đồng bộ hoá, được sắp xếp theo thứ tự từ thiết bị có phiên được sửa đổi gần đây nhất đến thiết bị có phiên được sửa đổi gần đây nhất. Các đối tượngtabs.Tab
được sắp xếp theo thứ tự gần đây nhất trongwindows.Window
của các đối tượngsessions.Session
.
-
Giá trị trả về
-
Promise<Device[]>
Chrome 96 trở lênLời hứa được hỗ trợ trong Tệp kê khai V3 trở lên, nhưng lệnh gọi lại được cung cấp để đảm bảo khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ phân giải bằng cùng một loại được truyền đến lệnh gọi lại.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
Lấy danh sách các thẻ và/hoặc cửa sổ đã đóng gần đây.
Thông số
Giá trị trả về
-
Promise<Session[]>
Chrome 96 trở lênLời hứa được hỗ trợ trong Tệp kê khai V3 trở lên, nhưng lệnh gọi lại được cung cấp để đảm bảo khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ phân giải bằng cùng một loại được truyền đến lệnh gọi lại.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
Mở lại windows.Window
hoặc tabs.Tab
, với một lệnh gọi lại không bắt buộc để chạy khi mục đã được khôi phục.
Thông số
-
sessionId
chuỗi không bắt buộc
windows.Window.sessionId
hoặctabs.Tab.sessionId
để khôi phục. Nếu bạn không chỉ định tham số này, thì phiên đã đóng gần đây nhất sẽ được khôi phục. -
callback
hàm không bắt buộc
Tham số
callback
có dạng như sau:(restoredSession: Session) => void
-
restoredSession
sessions.Session
chứa đối tượngwindows.Window
hoặctabs.Tab
đã khôi phục.
-
Giá trị trả về
-
Promise<Session>
Chrome 96 trở lênLời hứa được hỗ trợ trong Tệp kê khai V3 trở lên, nhưng lệnh gọi lại được cung cấp để đảm bảo khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ phân giải bằng cùng một loại được truyền đến lệnh gọi lại.
Sự kiện
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
Được kích hoạt khi các thẻ và/hoặc cửa sổ đã đóng gần đây thay đổi. Sự kiện này không theo dõi các thay đổi về phiên đã đồng bộ hoá.
Thông số
-
callback
hàm
Tham số
callback
có dạng như sau:() => void