Skip to main content
Version: v2

Get Session Details

Retrieve the session ID or a link to replay of the current session. The link can point to the beginning of the session or to the current moment time.

Parameters
    format string optional

    Possible values: url, id, url.now

    Enumerated value that defines what kind of ID should be returned:
    url - (default value) the returned URL links to the beginning of the session replay
    id - the session ID is returned
    url.now - the returned URL links to the moment in the replay when the method is invoked

Special Consideration

A session url or ID can only be returned by FS('getSession') if capture has begun. Before this FS('getSession') returns null or undefined. To be assured of getting a session url, you can use FS('observe') or the asynchronous version: FS('getSessionAsync'). More details about the FullStory client-side bootstrapping process can be found on our knowledge base.

FS('getSession', { format: 'url' })

Example Invocation

FS('observe', {
type: 'start',
callback: () => {
const sessionUrlFromBeginning = FS('getSession');
}
});
const sessionUrlAtTime = await FS('getSessionAsync', { format: 'url.now' });
Get the current session ID using the legacy _fs_ready callback
window['_fs_ready'] = function() {
const sessionId = FS('getSession', { format: 'id' });
};