Files

Justin Halsall e4e73596ec Migrates to vite@6 to drop base64 inlined worker source from all bundles (#1762 )

* chore: maintain CSS output file name in vite@6.0.1

Without this change, build would fail because the produced stylesheet assumes
the `package.json['name']` i.e., `styles/rrweb.css`. To maintain the existing
behavior, these changes are required.

See https://vite.dev/guide/migration.html#customize-css-output-file-name-in-library-mode
* build(rrvideo): upgrade playwright from 1.32.1 to 1.56.1

Update playwright dependency to latest version and refactor test execution options to use a shared configuration with increased timeout for stability.

* debug(rrvideo): add comprehensive logging to video transformation process

Add detailed console.log statements throughout the transformToVideo function to track execution flow and debug potential issues. Logging covers browser launch, context creation, page navigation, replay progress, and video file operations.

* ci(rrvideo): install playwright browsers and improve test output visibility

- Add Playwright Chromium installation step to CI workflow
- Change test execution stdio from 'pipe' to 'inherit' for better debugging

* fix(rrvideo): prevent autoplay and manually start playback after event listeners

Set autoPlay to false in replayer configuration and manually call play() after all event listeners are attached. This ensures event handlers are properly registered before playback begins, preventing potential race conditions.

Also refactor test execution options to separate stdio configuration from timeout settings for better control over test output visibility.

* fix(rrvideo): add timeout and error handling to replay process

Add comprehensive error handling to prevent hanging during video transformation:
- Add 2-minute timeout for replay finish event
- Add console and error listeners for better debugging
- Improve promise chain with proper error catching
- Clear timeout on successful completion or error

This prevents the process from hanging indefinitely when the replay finish event never fires.

* fix(rrvideo): add error handling and restructure replayer initialization

Wrap replayer initialization in try-catch block to handle potential errors gracefully. Restructure Player instantiation to use rrwebPlayer directly instead of rrwebPlayer.Player, and move width/height into props object for correct API usage. On error, log to console and trigger onReplayFinish callback to prevent hanging state.

* build(umd): rename record and replay globals

Update UMD build globals for recorder and replayer and
refresh documentation accordingly.

BREAKING CHANGE: UMD global names changed to rrwebRecord
and rrwebReplay.

* fix(rrvideo): adjust replay timeout to duration

* docs: update rrweb-player CDN script path

* Update vite.config.default.ts

Co-authored-by: Eoghan Murray <eoghan@getthere.ie>

---------

Co-authored-by: Rui <rui@conti.sh>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Eoghan Murray <eoghan@getthere.ie>

2026-04-01 12:00:00 +08:00

rrweb-record

Chore: Migrate build to vite (#1033 )

2026-04-01 12:00:00 +08:00

rrweb-replay

Chore: Migrate build to vite (#1033 )

2026-04-01 12:00:00 +08:00

scripts

Chore: Migrate build to vite (#1033 )

2026-04-01 12:00:00 +08:00

src

fix: ensure empty string replace/replaceSync clears stylesheets (#1774 )

2026-04-01 12:00:00 +08:00

test

fix: ensure empty string replace/replaceSync clears stylesheets (#1774 )

2026-04-01 12:00:00 +08:00

.gitignore

[Plugin] Live stream canvas via webrtc (#976 )

2026-04-01 12:00:00 +08:00

.release-it.json

CI: add a prettier GitHub action to format code automatically (#988 )

2026-04-01 12:00:00 +08:00

CHANGELOG.md

Version Packages (alpha) (#1780 )

2026-04-01 12:00:00 +08:00

package.json

Migrates to vite@6 to drop base64 inlined worker source from all bundles (#1762 )

2026-04-01 12:00:00 +08:00

README.md

Chore: Migrate build to vite (#1033 )

2026-04-01 12:00:00 +08:00

rollup.config.js

Enable preserveSource (#1309 )

2026-04-01 12:00:00 +08:00

tsconfig.json

Reverse monkey patch built in methods to support LWC (#1509 )

2026-04-01 12:00:00 +08:00

vite.config.entries.js

Chore: Migrate build to vite (#1033 )

2026-04-01 12:00:00 +08:00

vite.config.js

Chore: Migrate build to vite (#1033 )

2026-04-01 12:00:00 +08:00

vitest.config.ts

Chore: Migrate build to vite (#1033 )

2026-04-01 12:00:00 +08:00

README.md

Try rrweb

rrweb

This is a simpler version of the original rrweb README within this rrweb subpackage

中文文档

rrweb refers to 'record and replay the web', which is a tool for recording and replaying users' interactions on the web.

Guide

📚 Read the rrweb guide here. 📚

🍳 Recipes 🍳

Project Structure

rrweb mainly includes two funtions:

Record: The record function is used to record all the mutations in the DOM
Replay: The replay function is to replay the recorded mutations one by one according to the corresponding timestamp.

Roadmap

storage engine: do deduplication on a large number of rrweb sessions
compact mutation data in common patterns
provide plugins via the new plugin API, including:
- XHR plugin
- fetch plugin
- GraphQL plugin
- ...

Internal Design

Contribute Guide

Since we want the record and replay sides to share a strongly typed data structure, rrweb is developed with typescript which provides stronger type support.

Typescript handbook

Fork this repository.
Run yarn install in the root to install required dependencies for all sub-packages (note: npm install is not recommended).
Run yarn dev in the root to get auto-building for all the sub-packages whenever you modify anything.
Navigate to one of the sub-packages (in the packages folder) where you'd like to make a change.
Patch the code and run yarn test to run the tests, make sure they pass before you commit anything.
Push the code and create a pull request.