chrome.sessions

Properties

• deviceName

  string

  The name of the foreign device.

• sessions

  Session[]

  A list of open window sessions for the foreign device, sorted from most recently to least recently modified session.

Properties

• maxResults

  number optional

  The maximum number of entries to be fetched in the requested list. Omit this parameter to fetch the maximum number of entries (sessions.MAX_SESSION_RESULTS).

Properties

• lastModified

  number

  The time when the window or tab was closed or modified, represented in seconds since the epoch.

• tab

  Tab optional

  The tabs.Tab, if this entry describes a tab. Either this or sessions.Session.window will be set.

• window

  Window optional

  The windows.Window, if this entry describes a window. Either this or sessions.Session.tab will be set.

The maximum number of sessions.Session that will be included in a requested list.

Value

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

Retrieves all devices with synced sessions.

Parameters

• filter

  Filter optional

Returns

• Promise<Device[]>

  Chrome 96+

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

Gets the list of recently closed tabs and/or windows.

Parameters

• filter

  Filter optional

Returns

• Promise<Session[]>

  Chrome 96+

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

Reopens a windows.Window or tabs.Tab, with an optional callback to run when the entry has been restored.

Parameters

• sessionId

  string optional

  The windows.Window.sessionId, or tabs.Tab.sessionId to restore. If this parameter is not specified, the most recently closed session is restored.

Returns

• Promise<Session>

  Chrome 96+

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

Fired when recently closed tabs and/or windows are changed. This event does not monitor synced sessions changes.

Parameters

• callback

  function

  The callback parameter looks like:

  () => void