@rrweb/record
2.2.0 · 24 Oct 2026MIT1.1M / weekRepositoryHomepagenpmAtom feed
Upgrading @rrweb/record from 2.0.1 to 2.2.0
9 releases 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
- fixed
Release removed shadow trees from the mirror
- new
2.1.6nothing new or fixed in the note
- fixed
Improve performance of untainted
domaccessors. Since #1509 we use e.g.dom.parentNode(el)instead ofel.parentNodeto work around libraries that modify these accessors. Slight improvement to avoid a string allocation each time one of these is called; they are on every hot path. - fixed
Improvements in efficiency of mutation handling at record time; has been identified as a problem numerous times
- fixed
2.1.1 – 2.1.44 releases, nothing new or fixed in the notes
- fixed
Fix conversion of absolute to relative urls if url contains a hash
- fixed
27 internal lines (docs, tests, tooling) left out.