Nội dung mô tả
Sử dụng API chrome.sessions
để truy vấn và khôi phục các thẻ cũng như 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.
-
số phiên hoạt động
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 theo thứ tự 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 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
number
Thời gian mà cửa sổ hoặc thẻ bị đóng hoặc sửa đổi, biểu thị bằng mili giây kể từ thời gian bắt đầu của hệ thống.
-
tab
Thẻ không bắt buộc
tabs.Tab
, nếu mục này mô tả một thẻ. Bạn có thể đặt thuộc tính này hoặcsessions.Session.window
. -
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ổ. Bạn có thể đặt thuộc tính này hoặcsessions.Session.tab
.
Thuộc tính
MAX_SESSION_RESULTS
Số lượng sessions.Session
tối đa sẽ được đưa vào 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ó các phiên đã đồ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 đã đồ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 số ngày gần đây trongwindows.Window
của đối tượngsessions.Session
.
-
Giá trị trả về
-
Hứa hẹn<Thiết bị[]>
Chrome 96 trở lênLời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có 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ẽ được 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.
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
-
số phiên hoạt động
Danh sách các mục đã đóng theo thứ tự ngược lại mà chúng đã được đóng (thẻ hoặc cửa sổ đã đóng gần đây nhất sẽ nằm tại 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 được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có 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ẽ được 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
, tuỳ ý chạy lệnh gọi lại 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
để khôi phục. Nếu bạn không chỉ định tham số này, thì phiên bị đó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ề
-
Cam kết<Session>
Chrome 96 trở lênLời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có 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ẽ được 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 được thay đổi. Sự kiện này không giám sát các thay đổi về 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