chrome.sessions

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

    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ặ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()

Promise
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ị

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

Giá trị trả về

  • Promise<Device[]>

    Chrome 96 trở lên

    Lờ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()

Promise
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ố

  • 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:

    (sessions: Session[]) => void

    • phiên

      Danh sách các mục đã đóng theo thứ tự đảo ngược thời điểm đóng (thẻ hoặc cửa sổ đã đóng gần đây nhất sẽ ở chỉ mục 0). Các mục này có thể chứa thẻ hoặc cửa sổ.

Giá trị trả về

  • Promise<Session[]>

    Chrome 96 trở lên

    Lờ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()

Promise
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ố

Giá trị trả về

  • Promise<Session>

    Chrome 96 trở lên

    Lờ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