rrweb
2.2.0 · 24 Oct 2026MIT4.2M / weekRepositoryHomepagenpmAtom feed
Upgrading rrweb from 2.1.7 to 2.2.0
1 release in betweenevery note read
Release by release
- new
Add a top-level annotation event with
record.addAnnotation()andreplayer.on('annotation', handler). Annotation data usestype: 'caption'ortype: 'timelineMarker'. ImportannotationDatafrom@rrweb/typesto 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
messagelistener. - fixed
A same-origin iframe is observed once instead of re-observed on every full snapshot (
checkoutEveryNth/checkoutEveryNms/manualtakeFullSnapshot), 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-
MutationObserverhelper 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
- new
4 internal lines (docs, tests, tooling) left out.