chrome.sessions

Deskripsi

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

Izin

sessions

Jenis

Device

Properti

• deviceName

  string

  Nama perangkat asing.

• sessions

  Sesi[]

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

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, dinyatakan dalam milidetik sejak epoch.

• Subscription

  Tab opsional

  tabs.Tab, jika entri ini mendeskripsikan sebuah tab. Nilai ini atau sessions.Session.window akan ditetapkan.

• jendela

  Jendela opsional

  windows.Window, jika entri ini mendeskripsikan jendela. Nilai 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,
)

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 secara berurutan dari perangkat dengan sesi yang terakhir diubah ke perangkat dengan sesi yang paling lama diubah. Objek tabs.Tab diurutkan berdasarkan keterkinian di windows.Window objek sessions.Session.

Hasil

• Promise<Perangkat[]>

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

getRecentlyClosed()

Promise

chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

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

Parameter

• filter

  Filter opsional

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (sessions: Session[])=>void

  • sessions

    Sesi[]

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

Hasil

• Promise<Session[]>

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

restore()

Promise

chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

Membuka kembali windows.Window atau tabs.Tab, dengan callback opsional yang akan 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<Sesi>

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

Peristiwa

onChanged

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

Diaktifkan jika tab dan/atau jendela yang baru saja ditutup berubah. Acara ini tidak memantau perubahan sesi yang disinkronkan.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  ()=>void