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 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:(devices: Device[]) => void
-
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. Objektabs.Tab
diurutkan berdasarkan keterkinian diwindows.Window
objeksessions.Session
.
-
Hasil
-
Promise<Perangkat[]>
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. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
Mendapatkan daftar tab dan/atau jendela yang baru saja ditutup.
Parameter
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. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.
restore()
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
, atautabs.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
sessions.Session
yang berisi objekwindows.Window
atautabs.Tab
yang dipulihkan.
-
Hasil
-
Promise<Sesi>
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. 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