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

セッション 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.

ブラウザ実装状況

ChromeEdgeFirefoxFirefox for AndroidOpera
Filter 有り 無し52 無し 有り
MAX_SESSION_RESULTS 有り 無し52 無し 有り
Session 有り 無し52 * 無し 有り
forgetClosedTab 無し 無し55 無し 無し
forgetClosedWindow 無し 無し55 無し 無し
getRecentlyClosed 有り 無し52 無し 有り
getTabValue 無し 無し57 無し 無し
getWindowValue 無し 無し57 無し 無し
onChanged 有り 無し53 無し 有り
removeTabValue 無し 無し57 無し 無し
removeWindowValue 無し 無し57 無し 無し
restore 有り 無し52 無し 有り
setTabValue 無し 無し57 無し 無し
setWindowValue 無し 無し57 無し 無し

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,