Packages

rrweb

2.2.0 · 24 Oct 2026MIT4.2M / weekRepositoryHomepagenpmAtom feed

Upgrading rrweb from 2.1.5 to 2.2.0

3 releases in betweenevery note read

0
changes to make
0
advisories fixed
1
new
5
fixes

Release by release

  1. 2.2.0

    24 Oct 20261 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. 2.1.7

    2 Oct 20261 fix
    • fixed

      Fix #1920 - normalization of '0px' in style sheets caused problems with the styled-components library, which built style elements text element by text element. Bug introduced

  3. 2.1.6nothing new or fixed in the note

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