This page was saved using WebZIP 7.0.3.1030 offline browser on 12/24/13 11:31:36.
Address: https://crxdoc-zh.appspot.com/extensions/sessions.html
Title: chrome.sessions - Google Chrome 扩展程序开发文档（非官方中文版）  •  Size: 32075

该 API 还是实验性的，仅对 dev 分支的 Chrome 用户可用。

chrome.sessions

描述： 使用 chrome.sessions API 查询和恢复浏览器会话中的标签页和窗口。
可用版本： 仅用于 Dev 分支。
权限： "sessions"

chrome.sessions 参考

类型

Filter

Filter 的属性

maxResults ( optional integer )

在请求的列表中获取项目的最大数目，省略该参数获取最大数目的项目（MAX_SESSION_RESULTS）。

Session

Session 的属性

lastModified ( integer )

窗口或标签页关闭或修改的时间，表示为 1970 年 1 月 1 日以来经过的毫秒数。

tab ( optional tabs.Tab )

如果该项目描述标签页的话则为 tabs.Tab 对象。该属性或 Session.window 中的某一个将会设置。

window ( optional windows.Window )

如果该项目描述窗口的话则为 windows.Window 对象。该属性或 Session.tab 中的某一个将会设置。

Device

Device 的属性

info ( string )

表示外来设备的所有信息。

sessions ( array of Session )

外来设备打开的窗口会话列表，会话按照最近修改到最早修改的顺序排列。

属性

MAX_SESSION_RESULTS

chrome.sessions.MAX_SESSION_RESULTS
MAX_SESSION_RESULTS ( 25 )
在请求的列表中获取项目的最大数目，省略该参数获取最大数目的项目（MAX_SESSION_RESULTS）。

方法

getRecentlyClosed

chrome.sessions.getRecentlyClosed(Filter filter, function callback)

获取最近关闭的标签页和/或窗口列表。

参数

filter ( optional Filter )

callback ( function )

callback 参数应该指定一个如下形式的函数： 

function(array of Session sessions) {...};

sessions ( array of Session )

关闭的项目列表，按照与关闭相反的顺序排列（最近关闭的标签页或窗口位于索引 0）。项目既可能包含标签页，也可能包含窗口。

getDevices

chrome.sessions.getDevices(Filter filter, function callback)

获取包含已同步会话的所有设备。

参数

filter ( optional Filter )

callback ( function )

callback 参数应该指定一个如下形式的函数： 

function(array of Device devices) {...};

devices ( array of Device )

每一个同步会话的 Device 对象列表，具有最近修改的会话的设备在前，具有最早修改的会话的设备在后，依次排列。Session 对象的 windows.Window 中，tabs.Tab 对象按照最近修改时间排列。

restore

chrome.sessions.restore(string sessionId, function callback)

重新打开 windows.Window（窗口）或 tabs.Tab（标签页），可以传递一个可选的回调函数，在项目恢复后调用。

参数

sessionId ( optional string )

要恢复的 windows.Window.sessionId 或 tabs.Tab.sessionId。

callback ( optional function )

如果您指定了 callback 参数，它应该指定一个如下形式的函数： 

function(Session restoredSession) {...};

restoredSession ( Session )

包含恢复后的 windows.Window 或 tabs.Tab 对象的 Session（会话）。