chrome.sessions

refresh date: 2026-09-25 robots: noindex

Deskripsi

Gunakan chrome.sessions API untuk membuat kueri dan memulihkan tab dan jendela dari sesi penjelajahan.

Izin

sessions

Jenis

Device

Properti

• deviceName

  string

  Nama perangkat asing.

• sesi

  Session[]

  Daftar sesi jendela yang terbuka untuk perangkat asing, diurutkan dari sesi yang paling baru hingga yang paling lama diubah.

Filter

Properti

• maxResults

  number opsional

  Jumlah maksimum entri yang akan diambil dalam daftar yang diminta. Hapus parameter ini untuk mengambil jumlah entri maksimum (sessions.MAX_SESSION_RESULTS).

Session

Properti

• lastModified

  angka

  Waktu saat jendela atau tab ditutup atau diubah, yang dinyatakan dalam detik sejak epoch.

• tab

  Tab opsional

  tabs.Tab, jika entri ini menjelaskan tab. Salah satu dari ini atau sessions.Session.window akan ditetapkan.

• jendela

  Jendela opsional

  windows.Window, jika entri ini mendeskripsikan jendela. Salah satu dari ini atau sessions.Session.tab akan ditetapkan.

Properti

MAX_SESSION_RESULTS

Jumlah maksimum sessions.Session yang akan disertakan dalam daftar yang diminta.

Nilai

25

Metode

getDevices()

Promise

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

Mengambil semua perangkat dengan sesi yang disinkronkan.

Parameter

• filter

  Filter opsional

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (devices: Device[]) => void

  • perangkat

    Perangkat[]

    Daftar objek sessions.Device untuk setiap sesi yang disinkronkan, diurutkan dari perangkat dengan sesi yang terakhir diubah hingga perangkat dengan sesi yang paling lama diubah. Objek tabs.Tab diurutkan berdasarkan keterkinian di windows.Window objek sessions.Session.

Hasil

• Promise<Device[]>

  Chrome 96+

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

getRecentlyClosed()

Promise

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

Mendapatkan daftar tab dan/atau jendela yang baru saja ditutup.

Parameter

• filter

  Filter opsional

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (sessions: Session[]) => void

  • sesi

    Session[]

    Daftar entri yang ditutup dalam urutan terbalik dari penutupannya (tab atau jendela yang terakhir ditutup akan berada di indeks 0). Entri dapat berisi tab atau jendela.

Hasil

• Promise<Session[]>

  Chrome 96+

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

restore()

Promise

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

Membuka kembali windows.Window atau tabs.Tab, dengan callback opsional untuk dijalankan saat entri telah dipulihkan.

Parameter

• sessionId

  string opsional

  windows.Window.sessionId, atau tabs.Tab.sessionId yang akan dipulihkan. Jika parameter ini tidak ditentukan, sesi yang terakhir ditutup akan dipulihkan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (restoredSession: Session) => void

  • restoredSession

    Sesi

    sessions.Session yang berisi objek windows.Window atau tabs.Tab yang dipulihkan.

Hasil

• Promise<Session>

  Chrome 96+

  Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

Acara

onChanged

chrome.sessions.onChanged.addListener(
  callback: function,
)

Diaktifkan saat tab dan/atau jendela yang baru saja ditutup diubah. Peristiwa ini tidak memantau perubahan sesi yang disinkronkan.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  () => void