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

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