Files

Eoghan Murray 1b79b5b6c2 inlineImages: Setting of image.crossOrigin is not always necessary (#1468 )

Setting of the `crossorigin` attribute is not necessary for same-origin images, and causes an immediate image reload (albeit from cache) necessitating the use of a load event listener which subsequently mutates the snapshot.  This change allows us to  avoid the mutation of the snapshot for the same-origin case.

* Modify inlineImages test to remove delay and show that we can inline images without mutation

* Add an explicit test for when the `image.crossOrigin = 'anonymous';` method is necessary.  Uses a combination of about:blank and our test server to simulate a cross-origin context

* Other test changes: there were some spurious rrweb mutations being generated by the addition of the crossorigin attribute that are now elimnated from the rrweb/__snapshots__/integration.test.ts.snap after this PR - this is good

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

scripts

Chore: Make inject script more robust on repl & stream (#1429 )

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

src

Replace Array.from with clean implementation (#1464 )

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

test

inlineImages: Setting of image.crossOrigin is not always necessary (#1468 )

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) (#1453 )

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

jest.config.js

Canvas recording: Preserve drawing buffer (#1273 )

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

package.json

Version Packages (alpha) (#1453 )

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

README.md

Fix #972 [Docs]: Add Readme.md to packages/rrweb (#1025 )

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

rollup.config.js

Enable preserveSource (#1309 )

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

tsconfig.json

fix CI error (#1045 )

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

README.md

Try rrweb

rrweb

This is a simpler version of the original rrewb 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

rrdom: an ad-hoc DOM for rrweb session data #419
storage engine: do deduplication on a large number of rrweb sessions
more end-to-end tests
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.

Protip: You can run yarn test in the root folder to run all the tests.

In addition to adding integration tests and unit tests, rrweb also provides a REPL testing tool.

Using the REPL tool

Core Team Members

_Yuyz0112

_Mark-Fenng

_eoghanmurray

_Juice10

Who's using rrweb