W skrócie
8 min czytaniaOtwartoźródłowa biblioteka rrweb zapisuje sesję przeglądarki jako jeden zserializowany zrzut DOM, po którym następuje strumień zdarzeń przyrostowych (mutacje DOM, ruchy myszy, kliknięcia, przewijanie, zmiany rozmiaru i wprowadzanie danych), a potem odbudowuje stronę w piaskownicy iframe, by ją odtworzyć. Nie nagrywa wideo. Ma licencję MIT, a jej przewodnik kieruje nowe projekty do @rrweb/record i @rrweb/replay zamiast starszego pakietu rrweb. Domyślnie maskuje tylko pola haseł, a maskAllInputs, blockClass, maskTextClass i ich odpowiedniki oparte na selektorach rozszerzają ten zakres.
Czym jest rrweb?
Otwartoźródłowa biblioteka rrweb, której nazwa to skrót od „record and replay the web", zapisuje sesję użytkownika w przeglądarce jako ustrukturyzowany JSON i odtwarza ją jako możliwą do obejrzenia rekonstrukcję strony. README projektu opisuje ją jako "a tool for recording and replaying users' interactions on the web." Projekt znajduje się pod adresem github.com/rrweb-io/rrweb, repozytorium powstało w październiku 2018 roku, a kod napisano w TypeScripcie, dzięki czemu rejestrator i odtwarzacz korzystają z jednego typowanego formatu zdarzeń.
rrweb to biblioteka, a nie produkt. Daje rejestrator emitujący zdarzenia i odtwarzacz, który je przyjmuje. To, dokąd trafiają zdarzenia, jak długo je przechowujesz i kto może je oglądać, leży już po stronie twojego kodu. Dlatego tak wiele komercyjnych narzędzi do odtwarzania sesji od niej zaczyna i dlatego odtwarzanie sesji w ogóle wygląda u różnych dostawców tak podobnie.
Czy rrweb nagrywa wideo?
Nie. rrweb zapisuje stan strony, a nie jej piksele. Na starcie rejestrator przechodzi przez DOM i serializuje go do drzewa węzłów, z których każdy ma unikalny identyfikator liczbowy. Dokumentacja serializacji nazywa ten wynik "descriptive": skrypty są zastępowane zaślepkami noscript, wartości pól trafiają do atrybutu value, względne adresy URL stają się bezwzględne, a zewnętrzne arkusze stylów są wstawiane bezpośrednio, dzięki czemu odtworzenie działa nawet przy niedostępnym oryginalnym CSS.
Po tym pełnym zrzucie wszystko jest już różnicą. Rejestrator podłącza MutationObserver i zestaw nasłuchiwaczy, a dokumentacja obserwatora wymienia, co jest rejestrowane:
- Zmiany DOM: tworzenie i usuwanie węzłów, zmiany atrybutów i tekstu
- Ruchy myszy
- Interakcje myszą: naciśnięcie i zwolnienie przycisku, kliknięcie, dwukrotne kliknięcie, menu kontekstowe, fokus, utrata fokusu oraz początek, ruch i koniec dotyku
- Przewijanie strony lub elementu
- Zmiany rozmiaru okna
- Wprowadzanie danych
Każde zdarzenie ma timestamp i liczbowy type. Typy zdarzeń to DomContentLoaded, Load, FullSnapshot, IncrementalSnapshot, Meta i Custom, a zdarzenia przyrostowe dodają pole data.source, które mówi, czy zmiana była mutacją, ruchem myszy, przewinięciem itd.
Odtwarzacz odbudowuje zrzut w elemencie iframe i po kolei stosuje zdarzenia przyrostowe. Nigdy nie wykonuje JavaScriptu nagranej strony. Dokumentacja piaskownicy rrweb wyjaśnia, że atrybut sandbox elementu iframe blokuje wysyłanie formularzy, wyskakujące okna, takie jak window.open, oraz skrypty, w tym wbudowane procedury obsługi i adresy javascript:. Ponieważ strona jest odbudowywana z węzłów, tekst w odtworzeniu jest prawdziwym tekstem, który można zaznaczyć. Jeśli potrzebujesz pliku wideo, monorepo zawiera rrvideo, opisane jako "a tool for transforming the session recorded by rrweb into a video."
Ta sama zależność od MutationObserver wyznacza minimalne wymagania wobec przeglądarek. Przewodnik stwierdza, że "rrweb does not support IE11 and below because it uses the MutationObserver API".
Które pakiety rrweb zainstalować?
Przewodnik rrweb zaleca w większości projektów @rrweb/record oraz @rrweb/replay, a @rrweb/all, gdy chcesz jednym importem objąć nagrywanie, odtwarzanie i packer. Tabela wymienia główne pakiety monorepo zgodnie z opisem w README pakietów. W chwili pisania tego tekstu każdy z nich miał w npm wersję 2.1.6, opublikowaną 18 września 2026 roku.
| Pakiet | Do czego służy |
|---|---|
@rrweb/record | Kod nagrywający, przeznaczony do uruchamiania w aplikacji front-endowej lub na stronie |
@rrweb/replay | Odbudowuje i odtwarza nagrane zdarzenia w elemencie iframe |
@rrweb/all | Nagrywanie, odtwarzanie i packer w jednym pakiecie, bez wtyczek |
rrweb-player | Interfejs odtwarzania z pauzą, przewijaniem do przodu i wyszukiwaniem, oparty na @rrweb/replay |
rrweb-snapshot | Serializuje i odbudowuje DOM, stanowi podstawę zdarzenia FullSnapshot |
@rrweb/packer | Kompresja poszczególnych zdarzeń przed przesłaniem przez sieć |
@rrweb/types, @rrweb/utils | Wspólne typy i funkcje pomocnicze |
rrdom, rrdom-nodejs | Wirtualny DOM do przewijania mutacji podczas odtwarzania oraz jego wersja dla Node.js |
rrvideo | Konwertuje nagranie na wideo |
rrweb | Pierwotny pakiet łączący nagrywanie i odtwarzanie |
W przypadku pierwotnego pakietu rrweb dokumentacja i rejestr się rozchodzą. Przewodnik mówi: "The rrweb package is deprecated. It still works, but new projects should use @rrweb/record and @rrweb/replay." W npm rrweb 2.1.6 nie ma jednak żadnego oznaczenia o wycofaniu i nadal jest pobierany częściej niż jego następca: API pobrań npm odnotowało w tygodniu od 15 do 21 września 2026 roku 1 874 214 pobrań rrweb wobec 498 366 dla @rrweb/record. Instalując go, nie dostaniesz żadnego ostrzeżenia. Jeśli zaczynasz od zera, postępuj zgodnie z przewodnikiem i zainstaluj osobne pakiety, bo to właśnie rrweb opiekunowie projektu planują odchudzić i usunąć.
Na jakiej licencji udostępniono rrweb?
rrweb jest udostępniany na licencji MIT. Plik LICENSE w repozytorium zaczyna się od "Copyright (c) 2018 Contributors", a npm podaje MIT dla każdego z powyższych pakietów. Licencja MIT pozwala używać, modyfikować i dystrybuować rrweb w zamkniętym oprogramowaniu komercyjnym, o ile zachowasz informację o prawach autorskich i tekst licencji.
Ta liberalna licencja tłumaczy powstawanie forków. Pakiet replay od Sentry zależy, według swojego package.json w repozytorium sentry-javascript, od @sentry/rrweb i @sentry/rrweb-snapshot. SDK przeglądarkowe PostHog zależy od @posthog/rrweb i @posthog/rrweb-record. Obaj dostawcy utrzymują własne kopie, więc poprawka w głównym projekcie rrweb nie dociera do ich użytkowników, dopóki dostawca jej nie scali, a nazwy opcji i wartości domyślne w ich SDK różnią się od tych w rrweb.
Które opcje rrweb odpowiadają za prywatność?
rrweb udostępnia ustawienia prywatności jako opcje funkcji record(). Poniższe nazwy i wartości domyślne pochodzą z tabeli Record Options w guide.md.
| Opcja | Wartość domyślna | Do czego służy |
|---|---|---|
blockClass | 'rr-block' | Elementy do zablokowania, jako ciąg znaków lub RegExp |
blockSelector | null | Selektor elementów do zablokowania |
ignoreClass | 'rr-ignore' | Elementy, których zdarzenia wprowadzania są ignorowane, jako ciąg znaków lub RegExp |
ignoreSelector | null | Selektor elementów do zignorowania |
maskTextClass | 'rr-mask' | Elementy, których tekst jest maskowany, jako ciąg znaków lub RegExp |
maskTextSelector | null | Selektor elementów do zamaskowania |
maskAllInputs | false | Maskuje całą zawartość pól jako * |
maskInputOptions | { password: true } | Maskuje wybrane rodzaje pól |
maskInputFn | brak | Własna logika maskowania zawartości pól |
maskTextFn | brak | Własna logika maskowania tekstu |
ignoreCSSAttributes | null | Tablica atrybutów CSS do zignorowania |
recordCanvas | false | Czy nagrywać elementy canvas |
recordCrossOriginIframes | false | Czy nagrywać elementy iframe z innych originów, co wymaga wstrzyknięcia rrweb do każdej ramki podrzędnej |
Te trzy klasy działają inaczej i łatwo je pomylić. Sekcja o prywatności w przewodniku wyjaśnia to dokładnie. Element z .rr-block "will not be recorded. Instead, it will replay as a placeholder with the same dimension." Element z .rr-ignore "will not record its input events." Natomiast "all text of elements with the class name .rr-mask and their children will be masked." Blokowanie usuwa element. Ignorowanie zachowuje element, ale pomija to, co wpisuje w nim użytkownik. Maskowanie zachowuje układ i zastępuje znaki.

Co rrweb maskuje domyślnie?
rrweb domyślnie maskuje tylko jedno: wartości pól haseł. Przewodnik ujmuje to w jednym wierszu: "input[type="password"] will be masked by default", a kod rejestratora to potwierdza: gdy maskAllInputs nie ma wartości true i nie przekażesz maskInputOptions, rejestrator przyjmuje { password: true }.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Wszystko inne, w tym pola e-mail, telefonu, adresu i tekstu swobodnego, opuszcza przeglądarkę we wpisanej postaci, chyba że skonfigurujesz więcej. maskInputOptions przyjmuje następujące klucze z typu MaskInputOptions w rrweb-snapshot: color, date, datetime-local, email, month, number, range, search, tel, text, time, url, week, textarea, select i password. Ustawienie maskAllInputs: true włącza je wszystkie naraz.
Nie ma opcji odmaskowania elementu podrzędnego wewnątrz zamaskowanego rodzica. rrweb nie ma ustawienia unmask ani unblock, więc dostawcy, którzy je oferują, zbudowali je we własnych forkach. Jeśli porównujesz biblioteki pod kątem ustawień domyślnych, nasze zestawienie miejsc, w których domyślna redakcja danych osobowych zostawia je odsłonięte, stawia rrweb obok Sentry i Clarity.
Praktyczna zasada przy nowej instalacji: zacznij od maskAllInputs: true, dodaj maskTextClass lub maskTextSelector do każdego kontenera wyświetlającego dane konta i ustaw blockClass na widżetach podmiotów trzecich, których nie masz powodu oglądać.

Jak zmniejszyć rozmiar nagrania rrweb?
Poradnik rrweb dotyczący przechowywania wymienia trzy strategie: blokowanie elementów DOM emitujących wiele zdarzeń, odrzucanie zdarzeń przez konfigurację sampling oraz kompresję lub deduplikację tego, co zostaje.
Opcja sampling rozrzedza zdarzenia wewnątrz nagrania, zamiast wybierać, które sesje nagrywać. Jej klucze pochodzą z typu SamplingStrategy. mousemove przyjmuje false lub próg ograniczania częstotliwości, mouseInteraction przyjmuje false lub mapę dla poszczególnych interakcji, scroll i media przyjmują progi ograniczania, input przyjmuje 'all' lub 'last', a canvas przyjmuje 'all' lub częstotliwość zrzutów od 1 do 60 na sekundę. Przykład z poradnika ustawia scroll: 150 z komentarzem "do not emit twice in 150ms" oraz input: 'last', aby zachować tylko końcową wartość wpisywanego ciągu. To próbkowanie na poziomie zdarzeń, czyli inna dźwignia niż częstotliwość próbkowania odtwarzania sesji udostępniana przez dostawców.
Do kompresji @rrweb/packer udostępnia funkcję pack przekazywaną jako packFn, a odpowiadająca jej funkcja unpack trafia do odtwarzacza jako unpackFn. Poradnik zaznacza, że kompresja całej sesji na backendzie zwykle wypada lepiej niż kompresja pojedynczych zdarzeń. slimDOMOptions usuwa części DOM, takie jak skrypty i komentarze, a checkoutEveryNth lub checkoutEveryNms wykonują w odstępach nowy pełny zrzut, co pozwala zachować tylko ostatni fragment sesji w chwili wystąpienia błędu. Przewodnik ostrzega, że to przybliżenie: przy checkoutEveryNth: 200 wysyłasz "the last 200 to 400 events".
Koszt nagrywania to również kwestia szybkości strony. Opublikowane dane o tym, ile rejestrator dodaje do rozmiaru paczki i czasu głównego wątku, zebrano w artykule o tym, jak bardzo odtwarzanie sesji spowalnia stronę.
Najczęściej zadawane pytania
Czy rrweb można używać komercyjnie za darmo?
Tak. rrweb ma licencję MIT, więc możesz używać go i modyfikować w zamkniętym oprogramowaniu komercyjnym. Musisz zachować informację o prawach autorskich i tekst licencji w dystrybuowanym kodzie.
Czy rrweb rejestruje to, co wpisują użytkownicy?
Tak, chyba że to zamaskujesz. rrweb nagrywa zdarzenia input i domyślnie maskuje tylko input[type="password"]. Ustaw maskAllInputs: true lub wymień konkretne typy pól w maskInputOptions, aby maskować więcej.
Czym różni się blockClass od maskTextClass w rrweb?
blockClass (domyślnie 'rr-block') usuwa element z nagrania i odtwarza zaślepkę tej samej wielkości. maskTextClass (domyślnie 'rr-mask') zachowuje element i zastępuje tekst w nim oraz w jego elementach podrzędnych.
Zainstalować rrweb czy @rrweb/record?
Zainstaluj @rrweb/record do nagrywania i @rrweb/replay do odtwarzania. Przewodnik rrweb określa łączony pakiet rrweb jako wycofany, choć npm nie pokazuje przy nim ostrzeżenia.
Czy rrweb może nagrywać canvas i elementy iframe?
Tak, ale obie opcje są domyślnie wyłączone. Wartości domyślne to recordCanvas: false i recordCrossOriginIframes: false, a elementy iframe z innych originów wymagają dodatkowo wstrzyknięcia rrweb do każdej ramki podrzędnej.
Które przeglądarki obsługuje rrweb?
rrweb obsługuje przeglądarki implementujące MutationObserver. Przewodnik stwierdza, że nie obsługuje Internet Explorera 11 i starszych wersji.
Jak opcja sampling w rrweb zmniejsza rozmiar nagrania?
Konfiguracja sampling rozrzedza zdarzenia wewnątrz sesji, zamiast odrzucać całe nagrania. scroll i media przyjmują próg ograniczania częstotliwości, podobnie jak mousemove, a input akceptuje 'last', aby zachować tylko końcową wartość wpisywanego ciągu. Przykład z poradnika ustawia scroll: 150, więc zdarzenie przewijania pojawia się najwyżej raz na 150 milisekund.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Czy nagranie rrweb można zamienić w plik wideo?
Monorepo rrweb zawiera rrvideo, opisane jako "a tool for transforming the session recorded by rrweb into a video." Narzędzie zamienia nagranie złożone ze zrzutu DOM i mutacji w prawdziwy plik wideo. Samo rrweb nadal nie nagrywa wideo, a rrvideo to osobny, późniejszy etap konwersji.
Ile pobrań ma wycofany pakiet rrweb w porównaniu z @rrweb/record?
W tygodniu od 15 do 21 września 2026 roku npm odnotował 1 874 214 pobrań pakietu rrweb wobec 498 366 dla @rrweb/record. Przewodnik określa rrweb jako wycofany, ale npm nie pokazuje przy nim takiej informacji, więc instalacja nie wyświetla ostrzeżenia. Starszy pakiet jest nadal pobierany znacznie częściej niż jego następca.
Czy Sentry i PostHog używają bezpośrednio oryginalnego pakietu rrweb?
Sentry i PostHog utrzymują własne forki, zamiast zależeć bezpośrednio od rrweb. Pakiet replay od Sentry zależy od @sentry/rrweb i @sentry/rrweb-snapshot, a SDK przeglądarkowe PostHog od @posthog/rrweb i @posthog/rrweb-record. Poprawka w głównym projekcie rrweb dociera do ich użytkowników dopiero po scaleniu przez dostawcę, a nazwy opcji i wartości domyślne w każdym forku różnią się od tych w rrweb.
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Częściej widoczni w Google
Jedno kliknięcie ustawia Flowsery jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych artykułach, trybie AI i Przeglądach od AI.
Jeszcze jedno...
Flowsery
Analityka witryny skupiona na przychodach
Każdy odwiedzający, źródło i konwersja w czasie rzeczywistym. Prosto, skutecznie i bez plików cookie.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Powiązane hasła ze słownika


Jak działa odtwarzanie sesji i czego nie widzi
Odtwarzanie sesji odbudowuje wizytę ze zmian DOM i zdarzeń wejścia, a nie z wideo. Zobacz, co rejestruje, co ukrywa maskowanie i czym różni się od map cieplnych.


Gdzie domyślne ustawienia redakcji PII w nagraniach sesji odsłaniają dane
Domyślna redakcja PII w nagraniach sesji bardzo się różni: rrweb maskuje tylko hasła, Sentry cały tekst, a Clarity liczby i adresy e-mail.


Co siedmiu dostawców publikuje o retencji danych z odtwarzania sesji
Retencja danych z odtwarzania sesji według dokumentacji FullStory, Hotjar, Clarity, LogRocket, PostHog, Sentry i Datadog oraz wymagania RODO.


Jak bardzo odtwarzanie sesji spowalnia stronę?
Czy odtwarzanie sesji spowalnia stronę? Odpowiedź na podstawie opublikowanych danych rrweb i Sentry o rozmiarze skryptu, CPU wątku głównego i wysyłce danych.


Jak działa opt-out z Google Analytics i co blokuje każda metoda
Opt-out z Google Analytics to dodatek do przeglądarki, flaga ga-disable w window lub odmowa zgody. Co każda metoda blokuje, kto nią steruje i gdzie się kończy.


Skąd pochodzą dane w odtwarzaniu sesji i mapach cieplnych
Odtwarzanie sesji a mapy cieplne: jedna wizyta kontra wiele oraz to, jak Hotjar, Datadog, PostHog, Clarity i FullStory tworzą mapy z nagrań lub niezależnie od nich.
Powiązane artykuły


Jak działa częstotliwość próbkowania odtwarzania sesji w Sentry, PostHog i innych
Częstotliwość próbkowania odtwarzania sesji określa, jaka część wizyt jest nagrywana. Zobacz, jak opisują ją Sentry, PostHog, LogRocket, Datadog i Clarity.


Czego RODO naprawdę wymaga od odtwarzania sesji
Ocena odtwarzania sesji pod kątem RODO opiera się na czterech kwestiach: podstawie z art. 6, danych szczególnych kategorii z art. 9, zgodzie z art. 5 ust. 3 ePrivacy i DPIA.


Czym naprawdę różnią się wściekłe kliknięcia od martwych kliknięć
Wściekłe i martwe kliknięcia różnią się przyczyną, a nie wagą problemu. Oto progi wykrywania publikowane przez PostHog, Hotjar, FullStory, LogRocket i Clarity.

