Mô tả
Dùng API chrome.sessions
để truy vấn cũng như 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
string
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ị nước ngoài, được sắp xếp từ phiên được sửa đổi gần đây nhất đến phiên được sửa đổi gần đây nhất.
Filter
Thuộc tính
-
kết quả tối đa
số không bắt buộc
Số lượng mục nhập tối đa có thể tìm nạp trong danh sách đã yêu cầu. Hãy bỏ qua tham 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 khi cửa sổ hoặc thẻ bị đóng hoặc sửa đổi, được biểu thị bằng mili giây kể từ thời gian bắt đầu của hệ thống.
-
phím tab
Thẻ 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 được đồng bộ hoá.
Tham số
-
filter
Bộ lọc không bắt buộc
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(devices: Device[]) => void
-
thiết bị
Thiết bị[]
Danh sách đối tượng
sessions.Device
cho mỗi phiên được đồ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ời gian gần đây trongwindows.Window
của đối tượngsessions.Session
.
-
Giá trị trả về
-
Cam kết<Thiết bị[]>
Chrome 96 trở lênLời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng 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.
Tham số
-
filter
Bộ lọc không bắt buộc
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(sessions: Session[]) => void
-
phiên
Phiên[]
Danh sách các mục nhập đã đóng theo thứ tự ngược với trạng thái đã đóng (thẻ hoặc cửa sổ đã đóng gần đây nhất sẽ nằm ở chỉ mục
0
). Các mục nhập có thể chứa thẻ hoặc cửa sổ.
-
Giá trị trả về
-
Cam kết<Phiên[]>
Chrome 96 trở lênLời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
Mở lại một windows.Window
hoặc tabs.Tab
và không bắt buộc dùng lệnh gọi lại để chạy khi mục nhập đã được khôi phục.
Tham số
-
sessionId
chuỗi không bắt buộc
windows.Window.sessionId
hoặctabs.Tab.sessionId
cần khôi phục. Nếu bạn không chỉ định thông số này, thì phiên đã đóng gần đây nhất sẽ được khôi phục. -
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(restoredSession: Session) => void
-
restoredSession
sessions.Session
chứa đối tượngwindows.Window
hoặctabs.Tab
được khôi phục.
-
Giá trị trả về
-
Promise<Session>
Chrome 96 trở lênLời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.
Sự kiện
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
Được kích hoạt khi có thay đổi đối với các thẻ và/hoặc cửa sổ đã đóng gần đây. Sự kiện này không giám sát các thay đổi của phiên được đồng bộ hoá.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:() => void