chrome.sessions

refresh date: 2026-09-25 robots: noindex

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ị bên ngoài.

  • phiên

    Session[]

    Danh sách các phiên cửa sổ đang mở cho thiết bị bên 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 ít gần đây nhất.

Filter

Thuộc tính

  • maxResults

    number không bắt buộc

    Số lượng mục tối đa cần tìm nạp trong danh sách được yêu cầu. Bỏ qua tham số này để tìm nạp số lượng mục nhập tối đa (sessions.MAX_SESSION_RESULTS).

Session

Thuộc tính

  • lastModified

    số

    Thời điểm cửa sổ hoặc thẻ bị đóng hoặc sửa đổi, được biểu thị bằng giây kể từ thời điểm bắt đầu.

  • thẻ

    Tab không bắt buộc

    tabs.Tab, nếu mục này mô tả một thẻ. Trường 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ổ. Trường 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 đưa vào danh sách được yêu cầu.

Giá trị

25

Phương thức

getDevices()

Promise 
chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
): Promise<Device[]>

Truy xuất tất cả thiết bị có phiên đượ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ị

      Thiết bị[]

      Danh sách các đố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 ít gần đây nhất. Các đối tượng tabs.Tab được sắp xếp theo mức độ mới 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 chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getRecentlyClosed()

Promise 
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
): Promise<Session[]>

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

      Session[]

      Danh sách các mục đã đóng theo thứ tự ngược lại với thứ tự đóng (thẻ hoặc cửa sổ đóng gần đây nhất sẽ ở chỉ mục 0). Các mục 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 chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

restore()

Promise 
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
): Promise<Session>

Mở lại windows.Window hoặc tabs.Tab, kèm theo lệnh gọi lại không bắt buộc để chạy khi mục nhập đã được khôi phục.

Thông số

Giá trị trả về

  • Promise<Session>

    Chrome 96 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng 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