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