この翻訳は不完全です。英語から この記事を翻訳 してください。

セッション APIを使ってブラウザーが動作している間に閉じたタブやウィンドウを一覧、復帰します。

sessions.getRecentlyClosed() 関数は tabs.Tab 配列とwindows.Window オブジェクトを返し、これはブラウザーが動作している間に閉じられたタブやウィンドウを sessions.MAX_SESSION_RESULTS で定義される上限まで表します。

ウィンドウやタブの復帰は sessions.restore() 関数にてできます。復帰はタブを再オープンするだけではありません: タブの移動履歴を復帰して戻る/進むのボタンが動くようにもします。

この API は拡張機能にタブやウィンドウに関連する追加状態の保存させる関数グループも提供します。それで、タブやウィンドウが閉じられて順次復帰された場合、拡張機能は状態を取得できます。例えば、タブをグループ化する拡張機能は、これを使ってタブがどのグループにいるのかを記憶し、ユーザーがタブを復帰した時に正しいグループに復帰できるようになります。

セッション API を使うには "sessions" API パーミッションが必要です。

sessions.Filter
Enables you to restrict the number of Session objects returned by a call to sessions.getRecentlyClosed().
sessions.Session

Represents a tab or window that the user has closed in the current browsing session.

プロパティ

sessions.MAX_SESSION_RESULTS
The maximum number of sessions that will be returned by a call to sessions.getRecentlyClosed().

関数

sessions.forgetClosedTab()
Removes a closed tab from the browser's list of recently closed tabs.
sessions.forgetClosedWindow()
Removes a closed window from the browser's list of recently closed windows.
sessions.getRecentlyClosed()
Returns an array of Session objects, representing windows and tabs that were closed in the current browsing session (that is: the time since the browser was started).
sessions.restore()

Restores a closed tab or window.

sessions.setTabValue()

Store a key/value pair associated with a given tab.

sessions.getTabValue()

Retrieve a previously stored value for a given tab, given its key.

sessions.removeTabValue()

Remove a key/value pair from a given tab.

sessions.setWindowValue()

Store a key/value pair associated with a given window.

sessions.getWindowValue()

Retrieve a previously stored value for a given window, given its key.

sessions.removeWindowValue()

Remove a key/value pair from a given window.

イベント

sessions.onChanged

Fired when a tab or window is closed.

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxOperaAndroid 版 Firefox
FilterChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 52Opera 完全対応 ありFirefox Android 未対応 なし
MAX_SESSION_RESULTSChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 52Opera 完全対応 ありFirefox Android 未対応 なし
SessionChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 52
補足
完全対応 52
補足
補足 'Tab' objects in Sessions don't contain the 'url', 'title', or 'favIconUrl' properties.
Opera 完全対応 ありFirefox Android 未対応 なし
forgetClosedTabChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 55Opera 未対応 なしFirefox Android 未対応 なし
forgetClosedWindowChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 55Opera 未対応 なしFirefox Android 未対応 なし
getRecentlyClosedChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 52Opera 完全対応 ありFirefox Android 未対応 なし
getTabValueChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 57Opera 未対応 なしFirefox Android 未対応 なし
getWindowValueChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 57Opera 未対応 なしFirefox Android 未対応 なし
onChangedChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 53Opera 完全対応 ありFirefox Android 未対応 なし
removeTabValueChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 57Opera 未対応 なしFirefox Android 未対応 なし
removeWindowValueChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 57Opera 未対応 なしFirefox Android 未対応 なし
restoreChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 52Opera 完全対応 ありFirefox Android 未対応 なし
setTabValueChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 57Opera 未対応 なしFirefox Android 未対応 なし
setWindowValueChrome 未対応 なしEdge 未対応 なしFirefox 完全対応 57Opera 未対応 なしFirefox Android 未対応 なし

凡例

完全対応  
完全対応
未対応  
未対応
実装ノートを参照してください。
実装ノートを参照してください。

Example extensions

Acknowledgements

This API is based on Chromium's chrome.sessions API.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

ドキュメントのタグと貢献者

このページの貢献者: Uemmra3
最終更新者: Uemmra3,