rrweb-snapshot

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

Same major only

47 releases in betweennotes for 6

Other targets from 0.7.21Newest 0.x0.8.4

1.0.0 has no release note on GitHub or in the repository's changelog, so its breaking changes are missing from the counts below.

4+
changes to make: 0
advisories fixed: 15+
new: 59+
fixes

Counted from 6 of 47 release notes. Advisories are counted from the advisory database, in full.

Before you upgrade

Tick each one off as you go

Thanks @Juice10 & @rotemreiss! - Require rrweb-snapshot.rebuild() to use a trusted sandboxed iframe document by default.
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
NodeType enum was moved from rrweb-snapshot to @rrweb/types The following types where moved from rrweb-snapshot to @rrweb/types: documentNode, documentTypeNode, legacyAttributes, textNode, cdataNode, commentNode, elementNode, serializedNode, serializedNodeWithId, serializedElementNodeWithId, serializedTextNodeWithId, IMirror, INode, mediaAttributes, attributes and DataURLOptions
breaking2.0.0
Remove INode / node.__sn usage and use Mirror as the source of truth.
breaking2.0.0

Release by release

2.2.0
24 Oct 20261 fix
- fixed
  Release removed shadow trees from the mirror
2.1.4 – 2.1.74 releases, no release note
2.1.3
8 Sep 20262 fixes
- fixed
  Ignore autoplay attribute mutations on <video>/<audio> regardless of tag-name case.
- fixed
  Disable autocomplete on input fields during replay
2.1.2
8 Sep 20261 fix
- fixed
  Use the provided logger from player config instead of directly calling console.warn
2.1.1no release note
2.1.0
27 Jun 20261 fix
- fixed
  Fix conversion of absolute to relative urls if url contains a hash
2.0.1
3 Jun 20261 fix
- fixed
  Fix broken MutationObserver in Webkit/Safari when a webpage has been monkey patched by a 3rd party library
2.0.0
1 Jun 202615 new · 53 fixes
- new
  Video and Audio elements now also capture playbackRate, muted, loop, volume.
- new
  Record dialog's modal status for replay in rrweb. (Currently triggering dialog.showModal() is not supported in rrweb-snapshot's rebuild)
- new
  Extends maskInputFn to pass the HTMLElement to the deciding function
- new
  Ensure password inputs remain masked when switching input type

Upgrade to 2.2.0

npm install rrweb-snapshot@2.2.0

What 2.2.0 needs

Reading 2.2.0's manifest…

Check against your package.json

Which of your other dependencies stand in the way of 2.2.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-snapshot from 0.7.21 to 2.2.0

Before you upgrade

Release by release

2.2.0

2.1.3

2.1.2

2.1.0

2.0.1

2.0.0