説明
ブラウジング セッションのタブとウィンドウをクエリして復元するには、chrome.sessions
API を使用します。
権限
sessions
型
Device
プロパティ
-
deviceName
文字列
外部デバイスの名前。
-
sessions
セッション[]
外部デバイスで開いているウィンドウ セッションのリスト。セッションが新しい順に並べられます。
Filter
プロパティ
-
maxResults
数値(省略可)
リクエストされたリストで取得するエントリの最大数。最大エントリ数(
sessions.MAX_SESSION_RESULTS
)をフェッチするには、このパラメータを省略します。
Session
プロパティ
-
lastModified
数値
ウィンドウまたはタブが閉じられたか、変更された時刻。エポックからのミリ秒単位で表されます。
-
タブ
タブ (省略可)
tabs.Tab
(このエントリがタブを記述している場合)。これかsessions.Session.window
のどちらかが設定されます。 -
窓
計測期間 (省略可)
windows.Window
(このエントリがウィンドウを記述している場合)。これかsessions.Session.tab
のどちらかが設定されます。
プロパティ
MAX_SESSION_RESULTS
リクエストされたリストに含まれる sessions.Session
の最大数。
値
25
メソッド
getDevices()
chrome.sessions.getDevices(
filter?: Filter,
callback?: function,
)
セッションが同期されているすべてのデバイスを取得します。
パラメータ
-
フィルタ
フィルタ (省略可)
-
callback
関数(省略可)
callback
パラメータは次のようになります。(devices: Device[]) => void
-
デバイス
デバイス[]
各同期セッションの
sessions.Device
オブジェクトのリスト。セッションが最後に変更されたデバイスから最も変更の少ないセッションの順に並べられます。tabs.Tab
オブジェクトは、sessions.Session
オブジェクトのwindows.Window
内で新しい順に並べられます。
-
戻り値
-
Promise<デバイス[]>
Chrome 96 以降Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
最近閉じたタブやウィンドウのリストを取得します。
パラメータ
戻り値
-
Promise<セッション[]>
Chrome 96 以降Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
エントリが復元されたときに実行するオプションのコールバックを指定して、windows.Window
または tabs.Tab
を再開します。
パラメータ
-
sessionId
文字列(省略可)
復元する
windows.Window.sessionId
またはtabs.Tab.sessionId
。このパラメータが指定されていない場合、最後に閉じたセッションが復元されます。 -
callback
関数(省略可)
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