更新日: 2026-09-25 robots: noindex
説明
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,
callback?: function,
): Promise<Device[]>
同期されたセッションを持つすべてのデバイスを取得します。
パラメータ
-
filter
フィルタ 省略可
-
callback
function 省略可
callbackパラメータは次のようになります。(devices: Device[]) => void
-
デバイス
Device[]
同期された各セッションの
sessions.Deviceオブジェクトのリスト。セッションが最後に変更された日時が新しいデバイスから古いデバイスの順に並べ替えられます。tabs.Tabオブジェクトは、sessions.Sessionオブジェクトのwindows.Windowで新しさ順に並べ替えられます。
-
戻り値
-
Promise<Device[]>
Chrome 96 以降Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
): Promise<Session[]>
最近閉じたタブやウィンドウのリストを取得します。
パラメータ
戻り値
-
Promise<Session[]>
Chrome 96 以降Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
): Promise<Session>
windows.Window または tabs.Tab を再度開きます。エントリが復元されたときに実行するコールバックをオプションで指定できます。
パラメータ
-
sessionId
文字列 省略可
復元する
windows.Window.sessionIdまたはtabs.Tab.sessionId。このパラメータが指定されていない場合、最後に終了したセッションが復元されます。 -
callback
function 省略可
callbackパラメータは次のようになります。(restoredSession: Session) => void
-
restoredSession
復元された
windows.Windowオブジェクトまたはtabs.Tabオブジェクトを含むsessions.Session。
-
戻り値
-
Promise<Session>
Chrome 96 以降Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。
イベント
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
最近閉じたタブやウィンドウが変更されたときに呼び出されます。このイベントは、同期されたセッションの変更をモニタリングしません。
パラメータ
-
callback
関数
callbackパラメータは次のようになります。() => void