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.

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

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

faststats: {
	siteKey: "your_site_key",
	extensions: { sessionReplay: true },
}

import { init } from "@faststats/web";
import { sessionReplay } from "@faststats/web/replay";

init({
	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.

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.

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.

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.

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.