Skip to content

Console Recording

Nveal offers a powerful mechanism to record console outputs (console.log, console.info, console.warn, console.error) alongside session replays.

Why use Console Recording?

When a user experiences a visual bug or a broken flow, the session replay alone only shows what happened. Console recording gives you the critical context of why it happened by revealing the exact JavaScript errors or warnings thrown in the browser at that exact millisecond.

Console Demo

Interactive Timeline Navigation

The console panel isn't just a static list—it is deeply integrated with the session replay player:

  • Jump to Event: Clicking on any specific log or error in the list will instantly jump the video timeline to the exact millisecond that event occurred, saving you from having to scrub through the whole video.
  • Auto-Highlighting: As you watch the session replay, console outputs will automatically highlight in real-time exactly as they are thrown in the user's browser.

Configuration

To enable console recording, pass the recordConsole option when initializing the SDK.

recordConsole

  • Status: Optional
  • Type: boolean
  • Default: false

When set to true, Nveal begins capturing console output.

recordConsoleConfig

  • Status: Optional
  • Type: object

Provides fine-grained control over what console output is captured.

Property Type Description
level string[] Array of log levels to capture. Example: ['error', 'warn'].
maxConsolePayloadBytes number Limits the maximum payload size in bytes to prevent blowing up data bandwidth on extremely verbose logs.

Example

nveal.init({
  apiKey: 'YOUR_API_KEY',
  recordConsole: true,
  recordConsoleConfig: {
    level: ['log', 'error', 'warn', 'info'],
    maxConsolePayloadBytes: 8 * 1024 * 1024 // 8MB limit
  }
});