chrome.sessions

説明

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()

Promise 
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 以降でサポートされていますが、コールバックは下位互換性のために提供されています。同じ関数呼び出しで両方を使用することはできません。Promise は、コールバックに渡されたのと同じ型で解決されます。

getRecentlyClosed()

Promise 
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

最近閉じたタブやウィンドウのリストを取得します。

パラメータ

  • フィルタ

    フィルタ（省略可）

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    (sessions: Session[])=>void

    • sessions

      セッション[]

      閉じられたエントリのリスト。閉じられたときと逆の順序で返されます（最後に閉じたタブまたはウィンドウはインデックス 0 になります）。エントリにはタブまたはウィンドウのいずれかを含めることができます。

戻り値

  • Promise<Session[]>

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、コールバックは下位互換性のために提供されています。同じ関数呼び出しで両方を使用することはできません。Promise は、コールバックに渡されたのと同じ型で解決されます。

restore()

Promise 
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

エントリが復元されたときに実行するオプションのコールバックを指定して、windows.Window または tabs.Tab を再開します。

パラメータ

戻り値

  • Promise<Session>

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、コールバックは下位互換性のために提供されています。同じ関数呼び出しで両方を使用することはできません。Promise は、コールバックに渡されたのと同じ型で解決されます。

イベント

onChanged

chrome.sessions.onChanged.addListener(
  callback: function,
)

最近閉じたタブやウィンドウが変更されたときに呼び出されます。このイベントでは、同期されたセッションの変更はモニタリングされません。

パラメータ

  • callback

    機能

    callback パラメータは次のようになります。 

    ()=>void