説明
chrome.sessions API を使用すると、閲覧中のセッションからタブとウィンドウの問い合わせや復元を行うことができます。
権限
sessions型
Device
プロパティ
- deviceName
文字列
外部デバイスの名前。
- sessions
Session[]
外部デバイスの開いているウィンドウ セッションのリスト。最近変更されたセッションから順に並べられています。
Filter
プロパティ
- maxResults
number 省略可
リクエストされたリストで取得するエントリの最大数。このパラメータを省略すると、最大数のエントリ（
sessions.MAX_SESSION_RESULTS）が取得されます。
Session
プロパティ
- lastModified
数値
ウィンドウまたはタブが閉じられたか変更された時刻。エポックからの経過秒数で表されます。
- タブ
タブ 省略可
このエントリがタブを表す場合は
tabs.Tab。これまたはsessions.Session.windowのいずれかが設定されます。 - 窓
Window 省略可
このエントリがウィンドウを表す場合は、
windows.Window。これまたはsessions.Session.tabのいずれかが設定されます。
プロパティ
MAX_SESSION_RESULTS
リクエストされたリストに含まれる sessions.Session の最大数。
値
25
メソッド
getDevices()
chrome.sessions.getDevices(
filter?: Filter,
): Promise<Device[]>
同期されたセッションがあるすべてのデバイスを取得します。
パラメータ
- フィルタ
フィルタ（省略可）
戻り値
-
Promise<Device[]>
Chrome 96 以降
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
): Promise<Session[]>
最近閉じたタブまたはウィンドウのリストを取得します。
パラメータ
- フィルタ
フィルタ（省略可）
戻り値
-
Promise<Session[]>
Chrome 96 以降
restore()
chrome.sessions.restore(
sessionId?: string,
): Promise<Session>
windows.Window または tabs.Tab を再度開きます。エントリが復元されたときに実行するコールバックは省略可能です。
パラメータ
- sessionId
文字列 省略可
復元する
windows.Window.sessionIdまたはtabs.Tab.sessionId。このパラメータを指定しない場合、最後に閉じたセッションが復元されます。
戻り値
-
Promise<Session>
Chrome 96 以降
イベント
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
最近閉じたタブやウィンドウが変更されたときに発生します。このイベントは、同期されたセッションの変更をモニタリングしません。
パラメータ
- callback
関数
callbackパラメータは次のようになります。() => void