rrweb

2.2.0 · 24 Oct 2026MIT4.2M / weekRepository Homepage npm Atom feed

Same major only

1 release in betweenevery note read

Other targets from 1.1.3Latest2.2.0

6
changes to make: 0
advisories fixed: 31
new: 98
fixes

Before you upgrade

Tick each one off as you go

Split plugins out of rrweb and move them into their own packages: @rrweb/packer, @rrweb/rrweb-plugin-canvas-webrtc-record, @rrweb/rrweb-plugin-canvas-webrtc-replay, @rrweb/rrweb-plugin-sequential-id-record, @rrweb/rrweb-plugin-sequential-id-replay, @rrweb/rrweb-plugin-console-record, @rrweb/rrweb-plugin-console-replay. Check out the README of each package for more information or check out #1033 to see the changes.
breaking2.0.0
Distributed files have new filenames, paths and extensions. Important: If you reference distributed files or types directly, you might have to update your paths/filenames. E.g. you import from rrweb/typings/... or rrdom/es. However you run import rrweb from 'rrweb' you won't notice a difference with this change. If you include rrweb files directly in a script tag, you might have to update that path to include a the .umd.cjs files instead. All .js files now use ES modules which can be used in modern browsers, node.js and bundlers that support ES modules. All npm packages now also ship .cjs and .umd.cjs files. The .umd.cjs files are CommonJS modules that bundle all files together to make it easy to ship one file to browser environments (similar to the previous .js files). The .cjs files are CommonJS modules that can be used in older Node.js environments. Types should be better defined in package.json and if you need specific types they might be exported from new packages (for example PlayerMachineState and SpeedMachineState are now exported from @rrweb/replay). Check the package.json's main and exports field for the available files.
breaking2.0.0
Move shared rrweb event and recorder types into the new @rrweb/types package.
breaking2.0.0
Remove INode / node.__sn usage and use Mirror as the source of truth.
breaking2.0.0
Move browser-only rrdom features into the new rrdom package.
breaking2.0.0
Mark inlineImages and inlineStylesheet record options as deprecated in docs and public types while preserving existing behavior.
deprecated2.0.0

Release by release

2.0.0
1 Jun 202631 new · 98 fixes
- new
  Click events now include a .pointerType attribute which distinguishes between 'pen', 'mouse' and 'touch' events. There is no new PenDown/PenUp events, but these can be detected with a MouseDown/MouseUp + pointerType=pen
- new
  Full overhawl of video and audio element playback. More robust and fixes lots of bugs related to pausing/playing/skipping/muting/playbackRate etc.
- new
  Extends maskInputFn to pass the HTMLElement to the deciding function
- new
  Ensure password inputs remain masked when switching input type

6 internal lines (docs, tests, tooling) left out.

Upgrade to 2.0.0

npm install rrweb@2.0.0

What 2.0.0 needs

Reading 2.0.0's manifest…

Check against your package.json

Which of your other dependencies stand in the way of 2.0.0. Read once, not stored.

After upgrading

Run the type checker, the linter and the tests.
Build, and look for new deprecation warnings.
Update peer dependencies the new version asks for.

Upgrading rrweb from 1.1.3 to 2.0.0

Before you upgrade

Release by release

2.0.0