chrome.sessions

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

    Daftar sesi jendela terbuka untuk perangkat asing, diurutkan dari sesi yang terakhir diubah hingga sesi yang paling awal diubah.

Filter

Properti

  • maxResults

    nomor 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 ditampilkan dalam detik sejak epoch.

  • tab

    Tab opsional

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

  • jendela

    Jendela opsional

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

Properti

MAX_SESSION_RESULTS

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

Nilai

25

Metode

getDevices()

Janji
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

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

Hasil

  • Promise<Device[]>

    Chrome 96+

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

getRecentlyClosed()

Janji
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

      Daftar entri yang ditutup dalam urutan terbalik saat ditutup (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 Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

restore()

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

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

Parameter

Hasil

  • Promise<Session>

    Chrome 96+

    Promise hanya didukung untuk Manifest 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