@sentry-internal/rrweb

2.43.0 · 12 May 2026MIT47.8k / weekRepository Homepage npm Atom feed

Same major only

57 releases in betweennotes for 5

Other targets from 1.101.1Newest 1.x1.108.0

6+
changes to make: 0
advisories fixed: 32+
new: 104+
fixes

Counted from 5 of 57 release notes. Advisories are counted from the advisory database, in full.

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.3.0 – 2.43.043 releases, no release note
2.2.0
30 Oct 20231 new · 4 fixes
- new
  Add a top-level annotation event with record.addAnnotation() and replayer.on('annotation', handler). Annotation data uses type: 'caption' or type: 'timelineMarker'. Import annotationData from @rrweb/types to type annotation data. The player can display these annotations as captions and interactive timeline markers.
- fixed
  Stopping a recording now releases the root document's mutation buffer and observer — previously the document observer was only disconnected, so each start/stop cycle leaked one buffer — and removes the cross-origin iframe message listener.
- fixed
  A same-origin iframe is observed once instead of re-observed on every full snapshot (checkoutEveryNth/checkoutEveryNms/manual takeFullSnapshot), so a single iframe mutation is no longer emitted once per checkout; its observers are also released when the iframe is removed or navigates away.
- fixed
  The untainted-MutationObserver helper iframe used on WebKit/Safari is reference-counted, so it is torn down only when the last observer stops and will get rebuilt for a later recording.
- fixed
  Disconnect shadow-DOM observers when their host is removed
2.1.1 nothing new or fixed in the note
2.1.0
18 Oct 20231 fix
- fixed
  Fix that the replayer getCurrentTime() was getting 'stuck' in liveMode after last event was exhausted
2.0.1
13 Oct 20231 fix
- fixed
  Fix broken MutationObserver in Webkit/Safari when a webpage has been monkey patched by a 3rd party library
2.0.0
25 Sep 202331 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
1.101.2 – 1.108.09 releases, no release note

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

Upgrade to 2.43.0

npm install @sentry-internal/rrweb@2.43.0

What 2.43.0 needs

Reading 2.43.0's manifest…

Check against your package.json

Which of your other dependencies stand in the way of 2.43.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 @sentry-internal/rrweb from 1.101.1 to 2.43.0

Before you upgrade

Release by release

2.2.0

2.1.0

2.0.1

2.0.0