Deskripsi
Gunakan chrome.sessions
API untuk membuat kueri dan memulihkan tab serta jendela dari sesi penjelajahan.
Izin
sessions
Jenis
Device
Properti
-
deviceName
string
Nama perangkat asing.
-
sesi
Sesi[]
Daftar sesi periode terbuka untuk perangkat asing, diurutkan dari sesi yang paling baru diubah ke yang paling lama.
Filter
Properti
-
maxResults
angka 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, diwakili dalam milidetik sejak epoch.
-
tab
Tab opsional
tabs.Tab
, jika entri ini mendeskripsikan tab. Nilai ini atausessions.Session.window
akan ditetapkan. -
jendela
Jendela opsional
windows.Window
, jika entri ini mendeskripsikan jendela. Nilai ini atausessions.Session.tab
akan ditetapkan.
Properti
MAX_SESSION_RESULTS
Jumlah maksimum sessions.Session
yang akan disertakan dalam daftar yang diminta.
Nilai
25
Metode
getDevices()
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 ini:(devices: Device[]) => void
-
perangkat
Daftar objek
sessions.Device
untuk setiap sesi yang disinkronkan, diurutkan dari perangkat dengan sesi yang terakhir diubah ke perangkat dengan sesi yang terakhir diubah. Objektabs.Tab
diurutkan menurut keterkinian dalamwindows.Window
objeksessions.Session
.
-
Hasil
-
Promise<Device[]>
Chrome 96 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
Mendapatkan daftar tab dan/atau jendela yang baru saja ditutup.
Parameter
Hasil
-
Janji<Session[]>
Chrome 96 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
Membuka kembali windows.Window
atau tabs.Tab
, dengan callback opsional untuk dijalankan saat entri telah dipulihkan.
Parameter
-
sessionId
string opsional
windows.Window.sessionId
, atautabs.Tab.sessionId
yang akan dipulihkan. Jika parameter ini tidak ditentukan, sesi yang terakhir ditutup akan dipulihkan. -
callback
fungsi opsional
Parameter
callback
terlihat seperti ini:(restoredSession: Session) => void
-
restoredSession
sessions.Session
yang berisi objekwindows.Window
atautabs.Tab
yang dipulihkan.
-
Hasil
-
Promise<Session>
Chrome 96 dan yang lebih baruPromise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke 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 ini:() => void