Session Replay

Session replay records DOM mutations and user interactions using rrweb. Recordings are serialized events, not video.

Enable ReplayCopy Anchor Link

Import and add the session replay extension.

Copy Text
import { sessionReplay } from "@faststats/react/replay";

<Analytics siteKey="your_site_key" extensions={[sessionReplay()]} />;

In Nuxt, pass an options object instead of true to configure the recorder. Every option below works in all three packages.

Privacy and MaskingCopy Anchor Link

Input values are masked by default. Mask or block more of the page with selectors and classes.

Copy Text
sessionReplay({
	maskTextSelector: ".sensitive",
	blockSelector: ".no-record",
});

Any element you mark as blocked is replaced with a placeholder, so its content never leaves the browser.

Console RecordingCopy Anchor Link

Console output is not recorded unless you turn it on.

Copy Text
sessionReplay({
	recordConsole: true,
	consoleLevel: ["error", "warn"],
});

Network RecordingCopy Anchor Link

Network recording is off by default. Enabling it records resource URLs and timing data. Headers and bodies are not recorded unless you opt in through networkOptions.

Copy Text
sessionReplay({
	recordNetwork: true,
	networkOptions: {
		initiatorTypes: ["fetch", "xmlhttprequest"],
		transformRequestFn: (request) => {
			const url = new URL(request.name);
			if (url.pathname.startsWith("/private/")) return;
			url.search = "";
			request.name = url.toString();
			return request;
		},
	},
});

networkOptions is passed to rrweb’s network plugin and has no effect unless recordNetwork is true. Return nothing from transformRequestFn to drop a request. recordHeaders, recordBody, and recordInitialRequests can also be set there; redact sensitive data before enabling headers or bodies.

Requests to FastStats collection endpoints, including a custom baseUrl, are always excluded.

Batching and LimitsCopy Anchor Link

Replay events are buffered in the browser and uploaded in gzip-compressed batches. The recorder also flushes when the page is hidden, when the session rotates, and when a batch reaches its event or byte limit.

When a recording ends, for example because the page is closed, the remaining events are sent uncompressed in batches of at most maxLowLatencyBatchSizeBytes so they fit in a request that outlives the page. This option can only be lowered from its default.

If the queue limits are reached, capture stops for that recording instead of leaving a gap.

Recording TuningCopy Anchor Link

sampling and slimDOMOptions are passed to rrweb and default to throttled mouse movement and scroll events and a DOM snapshot without scripts, comments, and non-essential <head> metadata.

mutationThrottle limits attribute changes on a single node so an animation that rewrites the same element many times a second does not bloat the recording.

ConsentCopy Anchor Link

Replay follows your consent setup. Setting consent to "denied" stops the recorder and discards buffered events. Switching between "anonymous" and "granted" drops what is buffered and starts a new recording, so the two modes never share one. In anonymous and cookieless mode recordings are not linked to an anonymous visitor. See Consent and Cookieless.