chrome.sessions

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ặc sessions.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ặc sessions.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()

Lời hứa

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ượng tabs.Tab được sắp xếp theo thời gian gần đây trong windows.Window của đối tượng sessions.Session.

Giá trị trả về

• Cam kết<Thiết bị[]>

  Chrome 96 trở lên

  Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

getRecentlyClosed()

Lời hứa

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ên

  Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

restore()

Lời hứa

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ặc tabs.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

    Phiên

    sessions.Session chứa đối tượng windows.Window hoặc tabs.Tab được khôi phục.

Giá trị trả về

• Promise&lt;Session&gt;

  Chrome 96 trở lên

  Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng 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ó 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