chrome.sessions

説明

ブラウジング セッションのタブとウィンドウをクエリして復元するには、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()

<ph type="x-smartling-placeholder"></ph> 約束 
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 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

getRecentlyClosed()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

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

パラメータ

  • フィルタ

    フィルタ （省略可）

  • callback

    関数（省略可）

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

    (sessions: Session[]) => void

    • sessions

      セッション[]

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

戻り値

  • Promise<セッション[]>

    Chrome 96 以降

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

restore()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

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

パラメータ

戻り値

  • Promise&lt;Session&gt;

    Chrome 96 以降

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

イベント

onChanged

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

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

パラメータ

  • callback

    関数

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

    () => void