chrome.sessions

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

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

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

Giá trị trả về

  • Hứa hẹn<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 để 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()

Cam kết 
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

      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ê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 để 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()

Cam kết 
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ặc tabs.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

Giá trị trả về

  • Cam kết<Session>

    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 để 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