Replay

AddCollectionIndicatorOptions

AddCollectionIndicatorOptions = AddIndicatorOptions

Options for adding an indicator to a replay collection.

AddSessionIndicatorOptions

AddSessionIndicatorOptions = AddIndicatorOptions & object

Options for adding an indicator to a replay session.

Type Declaration

showTabIcon?

optional showTabIcon: boolean

Includes the indicator icon on the session's replay tab.

Default

false

ConnectionInfo

ConnectionInfo = object

The connection information to use for the request.

Properties

host

host: string

The host to use for the request.

isTLS

isTLS: boolean

Whether the request is TLS.

port

port: number

The port to use for the request.

SNI?

optional SNI: string

The SNI to use for the request. If not provided, the SNI will be inferred from the host.

CurrentReplaySessionChangeEvent

CurrentReplaySessionChangeEvent = object

Event fired when the current replay session changes.

Properties

sessionId

sessionId: ID | undefined

The ID of the newly selected session, or undefined if no session is selected.

OpenTabOptions

OpenTabOptions = object

Options for opening a tab.

Properties

select?

optional select: boolean

Whether to select the tab after opening it. Defaults to true.

ReplayCollection

ReplayCollection = object

A collection in Replay.

Properties

id

id: ID

The ID of the collection.

name

name: string

The name of the collection.

sessionIds

sessionIds: ID[]

The sessions in the collection.

ReplayCollectionCreatedEvent

ReplayCollectionCreatedEvent = object

Event fired when a replay collection is created.

Properties

collection

collection: ReplayCollection

The newly created replay collection.

ReplayEntry

ReplayEntry = object

A replay entry.

Properties

id

id: ID

The ID of the entry.

requestId?

optional requestId: ID

The ID of the request associated with this entry, if any.

sessionId

sessionId: ID

The ID of the session this entry belongs to.

ReplayPageContext

ReplayPageContext = object

Replay page context.

Properties

kind

kind: "Replay"

selection

selection: Selection<ReplaySessionId>

ReplaySDK

ReplaySDK = object

Utilities to interact with Replay.

Properties

addCollectionIndicator()

addCollectionIndicator: (collectionId: ID, indicator: AddCollectionIndicatorOptions) => Indicator

Add an indicator to a replay collection. Indicators are displayed next to the collection name in the collections tree.

Parameters

Parameter	Type	Description
`collectionId`	`ID`	The ID of the collection to add the indicator to.
`indicator`	`AddCollectionIndicatorOptions`	The indicator configuration.

Returns

Indicator

A handle object with a remove method to remove the indicator.

Example

const indicator = sdk.replay.addCollectionIndicator(collectionId, {
  icon: "fas fa-folder-open",
  description: "Has unresolved findings",
});

// Later, remove the indicator
indicator.remove();

addRequestEditorExtension()

addRequestEditorExtension: (extension: Extension) => void

Add an extension to the request editor.

Parameters

Parameter	Type	Description
`extension`	`Extension`	The extension to add.

Returns

void

addRequestViewMode()

addRequestViewMode: (options: RequestViewModeOptions<RequestWritableViewModeProps>) => void

Add a custom view mode for requests.

Parameters

Parameter	Type	Description
`options`	`RequestViewModeOptions`<`RequestWritableViewModeProps`>	The view mode options.

Returns

void

addResponseViewMode()

addResponseViewMode: (options: ResponseViewModeOptions<ResponseViewModeProps>) => void

Add a custom response view mode.

Parameters

Parameter	Type	Description
`options`	`ResponseViewModeOptions`<`ResponseViewModeProps`>	The view mode options.

Returns

void

addSessionIndicator()

addSessionIndicator: (sessionId: ID, indicator: AddSessionIndicatorOptions) => Indicator

Add an indicator to a replay session. Indicators are displayed next to the session name in the collections tree.

Parameters

Parameter	Type	Description
`sessionId`	`ID`	The ID of the session to add the indicator to.
`indicator`	`AddSessionIndicatorOptions`	The indicator configuration.

Returns

Indicator

A handle object with a remove method to remove the indicator.

Example

const indicator = sdk.replay.addSessionIndicator(sessionId, {
  icon: "fas fa-exclamation-triangle",
  description: "Security warning",
  showTabIcon: true,
});

// Later, remove the indicator
indicator.remove();

addToSlot

addToSlot: DefineAddToSlotFn<ReplaySlotContent>

Add a component to a slot.

Param

The slot to add the component to.

Param

The content to add to the slot.

Example

addToSlot(ReplaySlot.SessionToolbarPrimary, {
  kind: "Command",
  commandId: "my-command",
  icon: "my-icon",
});

addToSlot(ReplaySlot.SessionToolbarSecondary, {
  kind: "Custom",
  component: MyComponent,
});

addToSlot(ReplaySlot.Topbar, {
  kind: "Button",
  label: "My Button",
  icon: "my-icon",
  onClick: () => {
    console.log("Button clicked");
  },
});

addWebsocketMessageViewMode()

addWebsocketMessageViewMode: (options: MessageViewModeOptions<MessageViewModeProps>) => void

Add a custom WebSocket message view mode.

Parameters

Parameter	Type	Description
`options`	`MessageViewModeOptions`<`MessageViewModeProps`>	The view mode options.

Returns

void

closeTab()

closeTab: (sessionId: ID) => void

Close a replay tab for the given session.

Parameters

Parameter	Type	Description
`sessionId`	`ID`	The ID of the session to close.

Returns

void

createCollection()

createCollection: (name: string) => Promise<ReplayCollection>

Create a new collection.

Parameters

Parameter	Type	Description
`name`	`string`	The name of the collection to create.

Returns

Promise<ReplayCollection>

createSession()

createSession: (source: RequestSource, collectionId?: ID, sessionKind?: ReplaySessionKind) => Promise<ReplaySession>

Create a session.

Parameters

Parameter	Type	Description
`source`	`RequestSource`	The source of the session to create.
`collectionId?`	`ID`	The ID of the collection to add the session to.
`sessionKind?`	`ReplaySessionKind`	-

Returns

Promise<ReplaySession>

Example

sdk.replay.createSession({
  type: "Raw",
  raw: "GET / HTTP/1.1\r\nHost: example.com\r\n\r\n",
  connectionInfo: {
    host: "example.com",
    port: 443,
    isTLS: true,
  },
});

deleteCollection()

deleteCollection: (id: ID) => Promise<boolean>

Delete a collection.

Parameters

Parameter	Type	Description
`id`	`ID`	The ID of the collection to delete.

Returns

Promise<boolean>

Whether the collection was deleted.

deleteSessions()

deleteSessions: (sessionIds: ID[]) => Promise<ID[]>

Delete a session.

Parameters

Parameter	Type	Description
`sessionIds`	`ID`[]	The IDs of the sessions to delete.

Returns

Promise<ID[]>

getCollections()

getCollections: () => ReplayCollection[]

Get the list of all replay collections.

Returns

ReplayCollection[]

The list of all replay collections.

getCurrentEntry()

getCurrentEntry: () => ReplayEntry | undefined

Get the entry currently displayed in the active replay session.

Returns

ReplayEntry | undefined

The active entry, or undefined if no entry is currently loaded.

Example

const currentEntry = sdk.replay.getCurrentEntry();
if (currentEntry) {
  console.log(`Currently viewing entry ${currentEntry.id}`);
} else {
  console.log("No entry is currently displayed");
}

getCurrentSession()

getCurrentSession: () => ReplaySession | undefined

Get the currently selected replay session.

Returns

ReplaySession | undefined

The currently selected replay session, or undefined if no session is selected.

Example

const currentSession = sdk.replay.getCurrentSession();
if (currentSession) {
  console.log(`Current session: ${currentSession.name}`);
} else {
  console.log("No session is currently selected");
}

getEntry()

getEntry: (entryId: ID) => ReplayEntry

Get a replay entry by its ID.

Parameters

Parameter	Type	Description
`entryId`	`ID`	The ID of the entry to get.

Returns

ReplayEntry

The replay entry.

Example

const entry = await sdk.replay.getEntry(entryId);
console.log(entry.id, entry.sessionId, entry.requestId);

getSelectedExchange()

getSelectedExchange: () => ReplaySelectedExchange | undefined

Get the currently selected Replay exchange.

Returns

ReplaySelectedExchange | undefined

The currently selected Replay exchange.

getSelectedRequest()

getSelectedRequest: () => RequestFull | undefined

Get the currently selected request.

Returns

RequestFull | undefined

The currently selected request.

getSelectedResponse()

getSelectedResponse: () => ResponseFull | undefined

Get the currently selected response.

Returns

ResponseFull | undefined

The currently selected response.

getSessions()

getSessions: (options?: object) => ReplaySession[]

Get the list of all replay sessions.

Parameters

Parameter	Type	Description
`options?`	{ `collectionId?`: `ID`; }	The options for getting the sessions.
`options.collectionId?`	`ID`	The ID of the collection to get the sessions for.

Returns

ReplaySession[]

The list of all replay sessions.

getTabs()

getTabs: () => ReplayTab[]

Get the list of all open replay tabs.

Returns

ReplayTab[]

The list of all open replay tabs.

moveSession()

moveSession: (sessionId: ID, collectionId: ID) => Promise<ReplaySession>

Move a session to a different collection.

Parameters

Parameter	Type	Description
`sessionId`	`ID`	The ID of the session to move.
`collectionId`	`ID`	The ID of the collection to move the session to.

Returns

Promise<ReplaySession>

The updated session.

onCollectionCreate()

onCollectionCreate: (callback: (event: ReplayCollectionCreatedEvent) => void) => ListenerHandle

Subscribe to replay collection creation events.

Parameters

Parameter	Type	Description
`callback`	(`event`: `ReplayCollectionCreatedEvent`) => `void`	The callback to call when a collection is created.

Returns

ListenerHandle

An object with a stop method that can be called to stop listening to collection creation events.

Example

const handler = sdk.replay.onCollectionCreate((event) => {
  console.log(`Collection ${event.collection.id} was created!`);
});

// Later, stop listening
handler.stop();

onCurrentSessionChange()

onCurrentSessionChange: (callback: (event: CurrentReplaySessionChangeEvent) => void) => ListenerHandle

Subscribe to current replay session changes.

Parameters

Parameter	Type	Description
`callback`	(`event`: `CurrentReplaySessionChangeEvent`) => `void`	The callback to call when the selected session changes.

Returns

ListenerHandle

An object with a stop method that can be called to stop listening to session changes.

Example

const handler = sdk.replay.onCurrentSessionChange((event) => {
  console.log(`Session ${event.sessionId} got selected!`);
});

// Later, stop listening
handler.stop();

onSessionCreate()

onSessionCreate: (callback: (event: ReplaySessionCreatedEvent) => void) => ListenerHandle

Subscribe to replay session creation events.

Parameters

Parameter	Type	Description
`callback`	(`event`: `ReplaySessionCreatedEvent`) => `void`	The callback to call when a session is created.

Returns

ListenerHandle

An object with a stop method that can be called to stop listening to session creation events.

Example

const handler = sdk.replay.onSessionCreate((event) => {
  console.log(`Session ${event.session.id} was created!`);
});

// Later, stop listening
handler.stop();

openTab()

openTab: (sessionId: ID, options?: OpenTabOptions) => void

Open a replay tab for the given session.

Parameters

Parameter	Type	Description
`sessionId`	`ID`	The ID of the session to open.
`options?`	`OpenTabOptions`	The options for opening the tab.

Returns

void

renameCollection()

renameCollection: (id: ID, name: string) => Promise<ReplayCollection>

Rename a collection.

Parameters

Parameter	Type	Description
`id`	`ID`	The ID of the collection to rename.
`name`	`string`	The new name of the collection.

Returns

Promise<ReplayCollection>

The updated collection.

renameSession()

renameSession: (id: ID, name: string) => Promise<ReplaySession>

Rename a session.

Parameters

Parameter	Type	Description
`id`	`ID`	The ID of the session to rename.
`name`	`string`	The new name of the session.

Returns

Promise<ReplaySession>

The updated session.

sendRequest()

sendRequest: (sessionId: ID, options: SendRequestOptions) => Promise<void>

Send a request to the Replay backend.

Parameters

Parameter	Type	Description
`sessionId`	`ID`	-
`options`	`SendRequestOptions`	The options for sending the request.

Returns

Promise<void>

Example

sendRequest(sessionId, {
  connectionInfo: {
    SNI: "example.com",
    host: "example.com",
    isTLS: true,
    port: 443,
  },
  raw: "GET / HTTP/1.1\r\nHost: example.com\r\n\r\n",
  updateContentLength: false,
});

showEntry()

showEntry: (sessionId: ID, entryId: ID) => Promise<void>

Show a specific entry in a replay session. This will open the session tab if not already open, set it as the selected session, and display the specified entry.

Parameters

Parameter	Type	Description
`sessionId`	`ID`	The ID of the session containing the entry.
`entryId`	`ID`	The ID of the entry to show.

Returns

Promise<void>

Example

await sdk.replay.showEntry(sessionId, entryId);

ReplaySelectedExchange

ReplaySelectedExchange = { entryId: ID; kind: typeof Http; request: RequestFull; response?: ResponseFull; sessionId: ID; } | { activeTab: "http-upgrade" | "messages"; entryId: ID; kind: typeof Ws; message?: ReplayWebSocketMessage; sessionId: ID; streamId?: ID; upgradeRequest?: RequestFull; upgradeResponse?: ResponseFull; }

The currently selected Replay exchange.

ReplaySession

ReplaySession = object

A session in Replay.

Properties

collectionId

collectionId: ID

The ID of the collection the session belongs to.

entryIds

entryIds: ID[]

The IDs of all entries in this session.

id

id: ID

The ID of the session.

name

name: string

The name of the session.

ReplaySessionCreatedEvent

ReplaySessionCreatedEvent = object

Event fired when a replay session is created.

Properties

session

session: ReplaySession

The newly created replay session.

ReplaySessionId

ReplaySessionId = string & object

A unique replay session identifier.

Type Declaration

__replaySessionId?

optional __replaySessionId: never

ReplaySessionKind

ReplaySessionKind = typeof ReplaySessionKind[keyof typeof ReplaySessionKind]

The kind of a replay session.

ReplaySlotContent

ReplaySlotContent<TProps> = { [K in ReplaySlot]: ButtonSlotContent | CustomSlotContent<TProps> | CommandSlotContent }

Content that can be added to replay slots.

Type Parameters

Type Parameter	Default type
`TProps` extends `SlotContentPropsGroup`	`SlotContentProps`

ReplayTab

ReplayTab = object

A replay tab.

Properties

sessionId

sessionId: ID

The ID of the session associated with this tab.

ReplayWebSocketMessage

ReplayWebSocketMessage = object

The currently edited WebSocket message in Replay.

Properties

direction

direction: "CLIENT" | "SERVER"

format

format: "BINARY" | "CLOSE" | "PING" | "PONG" | "TEXT"

raw

raw: string

RequestSource

RequestSource = { connectionInfo: ConnectionInfo; raw: string; type: "Raw"; } | { id: string; type: "ID"; }

Remarks

This type is a discriminated union with two possible shapes:

A raw request, containing the raw HTTP request string and connection information.
A reference to an existing request ID.

Example

// Using a raw request
const source: RequestSource = {
  type: "Raw",
  raw: "GET /api/data HTTP/1.1",
  connectionInfo: { ... }
};
// Using an ID
const source: RequestSource = {
  type: "ID",
  id: "request-123"
};

SendRequestOptions

SendRequestOptions = object

Options for sending a request.

Properties

background?

optional background: boolean

Whether to send the request in the background without updating the UI. If true, the request will not update the UI. If false, the UI will be updated to display the session and the new request. Defaults to false.

ReplaySessionKind

const ReplaySessionKind: object

The kind of a replay session.

Type Declaration

Http

readonly Http: "HTTP"

Ws

readonly Ws: "WS"

ReplaySlot

const ReplaySlot: object

The slots in the Replay UI.

Type Declaration

SessionToolbarPrimary

readonly SessionToolbarPrimary: "session-toolbar-primary"

The left side of the session toolbar.

SessionToolbarSecondary

readonly SessionToolbarSecondary: "session-toolbar-secondary"

The right side of the session toolbar.

readonly Topbar: "topbar"

The left side of the topbar.

Replay ​

AddCollectionIndicatorOptions ​

AddSessionIndicatorOptions ​

Type Declaration ​

showTabIcon? ​

Default ​

ConnectionInfo ​

Properties ​

host ​

isTLS ​

port ​

SNI? ​

CurrentReplaySessionChangeEvent ​

Properties ​

sessionId ​

OpenTabOptions ​

Properties ​

select? ​

ReplayCollection ​

Properties ​

id ​

name ​

sessionIds ​

ReplayCollectionCreatedEvent ​

Properties ​

collection ​

ReplayEntry ​

Properties ​

id ​

requestId? ​

sessionId ​

ReplayPageContext ​

Properties ​

kind ​

selection ​

ReplaySDK ​

Properties ​

addCollectionIndicator() ​

Parameters ​

Returns ​

Example ​

addRequestEditorExtension() ​

Parameters ​

Returns ​

addRequestViewMode() ​

Parameters ​

Returns ​

addResponseViewMode() ​

Parameters ​

Returns ​

addSessionIndicator() ​

Parameters ​

Returns ​

Example ​

addToSlot ​

Param ​

Param ​

Example ​

addWebsocketMessageViewMode() ​

Parameters ​

Returns ​

closeTab() ​

Parameters ​

Returns ​

createCollection() ​

Parameters ​

Returns ​

createSession() ​

Parameters ​

Returns ​

Example ​

deleteCollection() ​

Parameters ​

Returns ​

deleteSessions() ​

Parameters ​

Returns ​

getCollections() ​

Returns ​

getCurrentEntry() ​

Replay

AddCollectionIndicatorOptions

AddSessionIndicatorOptions

Type Declaration

showTabIcon?

Default

ConnectionInfo

Properties

host

isTLS

port

SNI?

CurrentReplaySessionChangeEvent

Properties

sessionId

OpenTabOptions

Properties

select?

ReplayCollection

Properties

id

name

sessionIds

ReplayCollectionCreatedEvent

Properties

collection

ReplayEntry

Properties

id

requestId?

sessionId

ReplayPageContext

Properties

kind

selection

ReplaySDK

Properties

addCollectionIndicator()

Parameters

Returns

Example

addRequestEditorExtension()

Parameters

Returns

addRequestViewMode()

Parameters

Returns

addResponseViewMode()

Parameters

Returns

addSessionIndicator()

Parameters

Returns

Example

addToSlot

Param

Param

Example

addWebsocketMessageViewMode()

Parameters

Returns

closeTab()

Parameters

Returns

createCollection()

Parameters

Returns

createSession()

Parameters

Returns

Example

deleteCollection()

Parameters

Returns

deleteSessions()

Parameters

Returns

getCollections()

Returns

getCurrentEntry()