browser.sessions

説明

chrome.sessions API を使用して、ブラウジング セッションからタブとウィンドウをクエリして復元します。

権限

sessions

型

Device

プロパティ

  • deviceName

    文字列

    外部デバイスの名前。

  • sessions

    外部デバイスで開いているウィンドウ セッションのリスト。変更されたセッションが新しい順に並べ替えられます。

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

browser.sessions.getDevices(
  filter?: Filter,
)
: Promise<Device[]>

同期されたセッションを持つすべてのデバイスを取得します。

パラメータ

戻り値

  • Promise<Device[]>

    Chrome 96 以降 Chrome 148 以降の browser.*

getRecentlyClosed()

browser.sessions.getRecentlyClosed(
  filter?: Filter,
)
: Promise<Session[]>

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

パラメータ

戻り値

  • Promise<Session[]>

    Chrome 96 以降 Chrome 148 以降の browser.*

restore()

browser.sessions.restore(
  sessionId?: string,
)
: Promise<Session>

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

パラメータ

  • sessionId

    文字列 省略可

    復元する windows.Window.sessionId または tabs.Tab.sessionId。このパラメータが指定されていない場合、最後に終了したセッションが復元されます。

戻り値

  • Promise<Session>

    Chrome 96 以降 Chrome 148 以降の browser.*

イベント

onChanged

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

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

パラメータ

  • callback

    関数

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

    () => void