---
title: "rrweb-player Breaking Changes on npm | Since.dev"
description: "What each rrweb-player release removed, renamed or changed: 18 breaking changes in 3 versions on npm, each with its source."
canonical_url: https://since.dev/packages/npm/rrweb-player
last_updated: 2026-06-01
---

# rrweb-player breaking changes

Every breaking API change we have recorded in rrweb-player on npm: 18 breaking changes in 3 versions. Below are its newest 3 versions, removals and renames first, each with its source.

Newest change June 1, 2026

## 2.0.0

16 breaking changes, first published June 1, 2026.

- **Removed** `RRwebPlayerOptions`  

RRwebPlayerOptions was removed in rrweb-player 2.0.0 [npmjs.com](https://www.npmjs.com/package/rrweb-player/v/2.0.0)
- **Renamed**  

Distributed files now use new filenames, paths and extensions, and .js files are ES modules. Update any direct imports of rrweb files, such as rrweb/typings or rrdom/es, and script tags that load the bundles. [github.com](https://github.com/rrweb-io/rrweb/releases/tag/rrweb-player%402.0.0)
- **Signature changed** `default`  

Was class rrwebPlayer extends SvelteComponent; now class Player extends Player_2. [npmjs.com](https://www.npmjs.com/package/rrweb-player/v/2.0.0)
- **Signature changed** `default.addEvent`  

Was addEvent(event: eventWithTime): void; now readonly addEvent: (event: eventWithTime) => void. [npmjs.com](https://www.npmjs.com/package/rrweb-player/v/2.0.0)
- **Signature changed** `default.addEventListener`  

Was addEventListener(event: string, handler: (params: any) => unknown): void; now readonly addEventListener: (event: string, handler: (params: unknown) => unknown) => void. [npmjs.com](https://www.npmjs.com/package/rrweb-player/v/2.0.0)
- **Signature changed** `default.constructor`  

Was constructor(options: RRwebPlayerOptions); now constructor(options: {data?: RRwebPlayerOptions\['props'\];} & RRwebPlayerOptions). [npmjs.com](https://www.npmjs.com/package/rrweb-player/v/2.0.0)
- **Signature changed** `default.getMetaData`  

Was getMetaData: Replayer\['getMetaData'\]; now readonly getMetaData: () => playerMetaData. [npmjs.com](https://www.npmjs.com/package/rrweb-player/v/2.0.0)
- **Signature changed** `default.getMirror`  

Was getMirror: () => typeof mirror; now readonly getMirror: () => Mirror. [npmjs.com](https://www.npmjs.com/package/rrweb-player/v/2.0.0)
- **Signature changed** `default.getReplayer`  

Was getReplayer: () => Replayer; now readonly getReplayer: () => Replayer. [npmjs.com](https://www.npmjs.com/package/rrweb-player/v/2.0.0)
- **Signature changed** `default.goto`  

Was goto: (timeOffset: number, play?: boolean) => void; now readonly goto: (timeOffset: number, play?: boolean | undefined) => void. [npmjs.com](https://www.npmjs.com/package/rrweb-player/v/2.0.0)

And 6 more in this version.

## 2.0.0-alpha.15

1 breaking change, first published June 1, 2026.

- **Renamed**  

Distributed files now use new filenames, paths and extensions, and .js files are ES modules. Update any direct imports of rrweb files, such as rrweb/typings or rrdom/es, and script tags that load the bundles. [github.com](https://github.com/rrweb-io/rrweb/releases/tag/rrweb-player%402.0.0-alpha.15)

## 2.0.0-alpha.5

1 breaking change, first published June 1, 2026.

- **Renamed**  

Bundled CommonJS scripts now use a .cjs suffix instead of .js. Update any script paths that reference the old filenames. [github.com](https://github.com/rrweb-io/rrweb/releases/tag/rrweb-player%402.0.0-alpha.5)

## Check your code

These are the changes. To see which of them reach your code, [scan a public repository](https://since.dev/scan.md), or have your coding agent call `check_code` with your manifest or lockfile over [MCP](https://since.dev/docs.md#mcp). [The API](https://since.dev/docs.md#api) reads every change in every version, not only the newest. On Team and up, a fix pull request opens for the changes that reach a connected repository. Nothing merges or deploys.

## Put your code on continuous management.

Scan a public repository now, or give your agent one line.

### See how out of date your code is.

[Scan a repository](https://since.dev/scan.md). Any public GitHub repository. No sign-in.

### Tell your agent what changed since it was trained.

`claude mcp add --transport http since https://api.since.dev/mcp`

---

Every page on this site as Markdown: https://since.dev/sitemap.md. For agents: https://since.dev/llms.txt.
