rrweb event

An rrweb event is a timestamped entry describing page state, a page change or browser activity. Events are JSON objects with a numeric `type`, a `timestamp` in milliseconds and, for most types, a `data` payload. A session contains a sequence of these events. One user action can produce several events.

Event fields

The type determines the event's purpose and payload. A full snapshot contains page state. An incremental snapshot describes a later change, with a source identifying the kind of activity.

For example, a mouse-move event can contain several positions:

JSON
{
  "type": 3,
  "data": {
    "source": 1,
    "positions": [{ "x": 320, "y": 180, "id": 42, "timeOffset": -50 }]
  },
  "timestamp": 1716220801456
}

The id refers to a node in the recorded page. See incremental source for change types and the events documentation for event payloads.

Related terms