TL;DR, kort antwoord
8 min leestijdDe open-source library rrweb legt een browsersessie vast als één geserialiseerde DOM-snapshot, gevolgd door een stroom incrementele events (DOM-mutaties, muisbewegingen, klikken, scrollen, formaatwijzigingen en invoer), en bouwt de pagina daarna opnieuw op in een gesandboxte iframe om hem af te spelen. Er wordt geen video opgenomen. De licentie is MIT, en de gids verwijst nieuwe projecten nu naar @rrweb/record en @rrweb/replay in plaats van het oudere pakket rrweb. Standaard maskeert het alleen wachtwoordvelden; maskAllInputs, blockClass, maskTextClass en hun selector-tegenhangers breiden dat uit.
Wat is rrweb?
De open-source library rrweb, kort voor "record and replay the web", legt de sessie van een gebruiker in de browser vast als gestructureerde JSON en speelt die af als een reconstructie van de pagina die je kunt bekijken. De README van het project omschrijft het als "een tool voor het opnemen en afspelen van interacties van gebruikers op het web." Het staat op github.com/rrweb-io/rrweb, de repository is aangemaakt in oktober 2018 en de code is geschreven in TypeScript, zodat recorder en player één getypeerd eventformaat delen.
rrweb is een library, geen product. Het geeft je een recorder die events uitzendt en een player die ze verwerkt. Waar die events heen gaan, hoe lang je ze bewaart en wie ze mag bekijken, regelt je eigen code. Door die verdeling beginnen zoveel commerciële replaytools ermee, en daarom lijkt sessie-replay in het algemeen van leverancier tot leverancier zo op elkaar.
Neemt rrweb video op?
Nee. rrweb legt de toestand van de pagina vast, niet de pixels. Bij de start loopt de recorder door de DOM en serialiseert die tot een boom van nodes, elk met een unieke numerieke id. Het serialisatiedocument van het project noemt die uitvoer "beschrijvend": scripts worden vervangen door placeholder-tags noscript, invoerwaarden worden gekopieerd naar een attribuut value, relatieve URL's worden absoluut en externe stylesheets worden inline gezet, zodat de replay nog steeds rendert als de oorspronkelijke CSS onbereikbaar is.
Na die volledige snapshot is alles een diff. De recorder koppelt een MutationObserver en een set listeners, en het observerdocument noemt wat er wordt vastgelegd:
- DOM-wijzigingen: nodes aanmaken en verwijderen, wijzigingen in attributen en tekst
- Muisbewegingen
- Muisinteractie: mouse up en down, klik, dubbelklik, contextmenu, focus, blur, en touch start, move en end
- Scrollen van de pagina of van elementen
- Wijzigingen in het vensterformaat
- Invoer
Elk event heeft een timestamp en een numeriek type. De eventtypes zijn DomContentLoaded, Load, FullSnapshot, IncrementalSnapshot, Meta en Custom, en incrementele events krijgen een veld data.source dat aangeeft of de wijziging een mutatie, een muisbeweging, een scroll enzovoort was.
De replayer bouwt de snapshot opnieuw op in een iframe en past de incrementele events op volgorde toe. Hij voert het JavaScript van de opgenomen pagina nooit uit. Het sandboxdocument van rrweb legt uit dat het attribuut sandbox van de iframe het verzenden van formulieren, pop-ups zoals window.open en scripts blokkeert, inclusief inline handlers en javascript:-URL's. Omdat de pagina uit nodes wordt opgebouwd, is tekst in een replay echte tekst die je kunt selecteren. Heb je toch een videobestand nodig, dan levert de monorepo rrvideo, die het omschrijft als "een tool die de door rrweb opgenomen sessie omzet in een video."
Diezelfde afhankelijkheid van MutationObserver bepaalt de minimale browser van rrweb. De gids zegt dat "rrweb IE11 en lager niet ondersteunt omdat het de API MutationObserver gebruikt".
Welke rrweb-pakketten moet je installeren?
De gids van rrweb raadt voor de meeste projecten @rrweb/record plus @rrweb/replay aan, en @rrweb/all als je één import wilt voor opnemen, afspelen en de packer. De tabel noemt de belangrijkste pakketten in de monorepo zoals de README van de pakketten ze beschrijft. Toen deze pagina werd geschreven, stonden ze allemaal op versie 2.1.6 op npm, gepubliceerd op 18 september 2026.
| Pakket | Wat het doet |
|---|---|
@rrweb/record | De opnamecode, bedoeld om in je front-end-app of pagina te draaien |
@rrweb/replay | Bouwt opgenomen events opnieuw op en speelt ze af in een iframe |
@rrweb/all | Opnemen, afspelen en de packer in één pakket, zonder plug-ins |
rrweb-player | Een afspeelinterface met pauzeren, vooruitspoelen en zoeken, gebouwd op @rrweb/replay |
rrweb-snapshot | Serialiseert de DOM en bouwt hem opnieuw op, de basis van het event FullSnapshot |
@rrweb/packer | Compressie per event vóór verzending over het netwerk |
@rrweb/types, @rrweb/utils | Gedeelde types en hulpfuncties |
rrdom, rrdom-nodejs | Een virtuele DOM om mutaties tijdens het afspelen snel door te spoelen, plus een Node.js-versie |
rrvideo | Zet een opname om in een video |
rrweb | Het oorspronkelijke pakket met opnemen en afspelen samen |
Bij het oorspronkelijke pakket rrweb spreken de documentatie en de registry elkaar tegen. De gids zegt: "Het pakket rrweb is verouderd. Het werkt nog, maar nieuwe projecten moeten @rrweb/record en @rrweb/replay gebruiken." Op npm heeft rrweb 2.1.6 geen melding dat het verouderd is, en het wordt nog steeds vaker gedownload dan de vervanger: de download-API van npm telde in de week van 15 tot 21 september 2026 1.874.214 downloads van rrweb, tegenover 498.366 voor @rrweb/record. Wie het installeert, krijgt geen waarschuwing. Begin je opnieuw, volg dan de gids en installeer de gesplitste pakketten, want het pakket rrweb is het pakket dat de maintainers willen afslanken en verwijderen.
Onder welke licentie is rrweb uitgebracht?
rrweb is uitgebracht onder de MIT License. Het bestand LICENSE in de repository begint met "Copyright (c) 2018 Contributors", en npm vermeldt MIT voor elk pakket hierboven. Met MIT mag je rrweb gebruiken, aanpassen en meeleveren in commerciële closed-source software, zolang je de copyright- en licentievermelding behoudt.
Die ruime licentie verklaart de forks. Het replaypakket van Sentry hangt af van @sentry/rrweb en @sentry/rrweb-snapshot, volgens de package.json in de repository sentry-javascript. De browser-SDK van PostHog hangt af van @posthog/rrweb en @posthog/rrweb-record. Beide leveranciers onderhouden een eigen kopie, dus een fix in de upstream van rrweb bereikt hun gebruikers pas als de leverancier hem samenvoegt, en de optienamen en standaardwaarden in hun SDK's wijken af van die van rrweb zelf.
Welke opties in rrweb regelen privacy?
rrweb biedt de privacyinstellingen aan als opties op record(). De namen en standaardwaarden hieronder komen uit de tabel Record Options in guide.md.
| Optie | Standaard | Wat het doet |
|---|---|---|
blockClass | 'rr-block' | Elementen om te blokkeren, als string of RegExp |
blockSelector | null | Een selector voor elementen om te blokkeren |
ignoreClass | 'rr-ignore' | Elementen waarvan invoerevents worden genegeerd, als string of RegExp |
ignoreSelector | null | Een selector voor elementen om te negeren |
maskTextClass | 'rr-mask' | Elementen waarvan de tekst wordt gemaskeerd, als string of RegExp |
maskTextSelector | null | Een selector voor elementen om te maskeren |
maskAllInputs | false | Maskeert alle invoer als * |
maskInputOptions | { password: true } | Maskeert bepaalde soorten invoer |
maskInputFn | geen | Eigen logica voor het maskeren van invoer |
maskTextFn | geen | Eigen logica voor het maskeren van tekst |
ignoreCSSAttributes | null | Een array met CSS-attributen om te negeren |
recordCanvas | false | Of canvas-elementen worden opgenomen |
recordCrossOriginIframes | false | Of cross-origin iframes worden opgenomen, waarvoor rrweb in elk childframe moet worden geïnjecteerd |
De drie klassen gedragen zich verschillend, en mensen halen ze door elkaar. Het privacygedeelte van de gids legt het uit. Een element met .rr-block "wordt niet opgenomen. In plaats daarvan wordt het afgespeeld als placeholder met dezelfde afmetingen." Een element met .rr-ignore "neemt zijn invoerevents niet op." En "alle tekst van elementen met de klassenaam .rr-mask en hun kinderen wordt gemaskeerd." Blokkeren haalt het element weg. Negeren houdt het element, maar laat vallen wat de gebruiker erin typt. Maskeren houdt de lay-out en vervangt de tekens.

Wat maskeert rrweb standaard?
rrweb maskeert standaard één ding: de waarde van wachtwoordvelden. De gids zegt het in één regel, "input[type="password"] wordt standaard gemaskeerd", en de broncode van de recorder bevestigt het: als maskAllInputs niet true is en je geen maskInputOptions meegeeft, valt de recorder terug op { password: true }.
Realtime dashboard
Doelen bijhouden
Tracking zonder cookies
Al het andere, inclusief velden voor e-mail, telefoon, adres en vrije tekst, verlaat de browser zoals het is getypt, tenzij je meer instelt. maskInputOptions accepteert deze sleutels, uit MaskInputOptions in de types van rrweb-snapshot: color, date, datetime-local, email, month, number, range, search, tel, text, time, url, week, textarea, select en password. Met maskAllInputs: true zet je ze allemaal tegelijk aan.
Er is geen optie om een kind binnen een gemaskeerde ouder weer zichtbaar te maken. rrweb heeft geen instelling unmask of unblock, dus leveranciers die dat aanbieden, hebben het in hun fork gebouwd. Vergelijk je libraries op standaardwaarden, dan zet ons overzicht van waar standaarden voor het verwijderen van persoonsgegevens data blootstellen rrweb naast Sentry en Clarity.
Een praktische regel voor een nieuwe installatie: begin met maskAllInputs: true, voeg maskTextClass of maskTextSelector toe aan elke container die accountdata toont en zet blockClass op widgets van derden die je geen reden hebt om te zien.

Hoe maak je een rrweb-opname kleiner?
Het opslagrecept van rrweb noemt drie strategieën: blokkeer DOM-elementen die veel events uitzenden, gebruik de configuratie sampling om events te laten vallen, en comprimeer of ontdubbel wat je bewaart.
De optie sampling dunt events binnen een opname uit in plaats van te kiezen welke sessies je opneemt. De sleutels komen uit het type SamplingStrategy. mousemove accepteert false of een throttledrempel, mouseInteraction accepteert false of een map per interactie, scroll en media accepteren throttledrempels, input accepteert 'all' of 'last', en canvas accepteert 'all' of een snapshotfrequentie tussen 1 en 60 per seconde. Het voorbeeld in het recept zet scroll: 150 met het commentaar "niet twee keer uitzenden binnen 150ms" en input: 'last' om alleen de laatste waarde van een getypte reeks te houden. Dat is sampling op eventniveau, een andere knop dan het samplingpercentage voor sessie-replay dat leveranciers aanbieden.
Voor compressie levert @rrweb/packer een functie pack die je als packFn meegeeft, en de bijbehorende unpack gaat als unpackFn naar de replayer. Het recept merkt op dat het comprimeren van de hele sessie in de backend meestal beter werkt dan compressie per event. slimDOMOptions haalt delen van de DOM weg, zoals scripts en commentaar, en checkoutEveryNth of checkoutEveryNms maken met tussenpozen een nieuwe volledige snapshot, zodat je alleen het laatste stuk van een sessie kunt bewaren als er een fout optreedt. De gids waarschuwt dat dit bij benadering werkt: met checkoutEveryNth: 200 stuur je uiteindelijk "de laatste 200 tot 400 events".
Opnemen kost ook paginasnelheid. De gepubliceerde cijfers over wat een recorder toevoegt aan bundlegrootte en tijd op de main thread staan in hoeveel sessie-replay een site vertraagt.
Veelgestelde vragen
Mag je rrweb gratis commercieel gebruiken?
Ja. rrweb heeft een MIT-licentie, dus je mag het gebruiken en aanpassen in commerciële closed-source software. Je moet de copyrightvermelding en de licentietekst bij de code houden die je uitlevert.
Legt rrweb vast wat gebruikers typen?
Ja, tenzij je het maskeert. rrweb neemt input-events op en maskeert standaard alleen input[type="password"]. Zet maskAllInputs: true of noem specifieke invoertypes in maskInputOptions om meer te maskeren.
Wat is het verschil tussen blockClass en maskTextClass in rrweb?
blockClass (standaard 'rr-block') haalt een element uit de opname en speelt een placeholder van dezelfde grootte af. maskTextClass (standaard 'rr-mask') houdt het element en vervangt de tekst erin en in de kinderen.
Moet ik rrweb of @rrweb/record installeren?
Installeer @rrweb/record voor het opnemen en @rrweb/replay voor het afspelen. De gids van rrweb noemt het gecombineerde pakket rrweb verouderd, ook al toont npm er geen waarschuwing over.
Kan rrweb canvas en iframes opnemen?
Ja, maar beide staan standaard uit. recordCanvas: false en recordCrossOriginIframes: false zijn de standaarden, en voor cross-origin iframes moet rrweb ook in elk childframe worden geïnjecteerd.
Welke browsers ondersteunt rrweb?
rrweb ondersteunt browsers die MutationObserver implementeren. De gids zegt dat Internet Explorer 11 en lager niet worden ondersteund.
Hoe maakt de optie sampling in rrweb opnames kleiner?
De configuratie sampling dunt events binnen een sessie uit in plaats van hele opnames te laten vallen. scroll en media accepteren een throttledrempel, mousemove ook, en input accepteert 'last' om alleen de laatste waarde van een getypte reeks te houden. Het voorbeeld in het opslagrecept zet scroll: 150, zodat een scroll maar eens per 150 milliseconden wordt uitgezonden.
Realtime dashboard
Doelen bijhouden
Tracking zonder cookies
Kun je een rrweb-opname omzetten in een videobestand?
De monorepo van rrweb levert rrvideo, omschreven als "een tool die de door rrweb opgenomen sessie omzet in een video." Daarmee wordt een opname die bestaat uit een DOM-snapshot en mutaties een echt videobestand. rrweb zelf neemt nog steeds geen video op; rrvideo is een aparte conversiestap achteraf.
Hoeveel downloads krijgt het verouderde pakket rrweb vergeleken met @rrweb/record?
In de week van 15 tot 21 september 2026 telde npm 1.874.214 downloads van het pakket rrweb tegenover 498.366 voor @rrweb/record. De gids noemt rrweb verouderd, maar npm toont er geen melding over, dus bij het installeren verschijnt geen waarschuwing. Het oudere pakket wordt nog steeds veel vaker gedownload dan de vervanger.
Gebruiken Sentry en PostHog het oorspronkelijke pakket rrweb rechtstreeks?
Sentry en PostHog onderhouden elk een eigen fork in plaats van rechtstreeks van rrweb af te hangen. Het replaypakket van Sentry hangt af van @sentry/rrweb en @sentry/rrweb-snapshot, en de browser-SDK van PostHog van @posthog/rrweb en @posthog/rrweb-record. Een fix in de upstream van rrweb bereikt hun gebruikers pas als de leverancier hem samenvoegt, en de optienamen en standaardwaarden van elke fork wijken af van die van rrweb zelf.
Was dit artikel nuttig?
Laat ons weten wat je ervan vindt!
Zie ons vaker in Google
Met één klik markeer je Flowsery als voorkeursbron, zodat onze artikelen hoger staan in je Topverhalen, AI-modus en AI-overzichten.
Voordat je gaat...
Flowsery
Analytics voor je website, met omzet voorop
Volg elke bezoeker, bron en conversie in realtime. Eenvoudig, krachtig en zonder cookies.
Realtime dashboard
Doelen bijhouden
Tracking zonder cookies
Gerelateerde begrippen


Zo werkt session replay, en dit kan het niet zien
Een session replay bouwt een bezoek opnieuw op uit DOM-mutaties en invoer-events, niet uit video. Zie wat het vastlegt, wat maskering verbergt en hoe het verschilt van heatmaps.


Waar de standaardinstellingen voor PII-redactie in sessiereplay data blootleggen
De standaardinstellingen voor PII-redactie in sessiereplay lopen sterk uiteen: rrweb maskeert alleen wachtwoorden, Sentry alle tekst, Clarity cijfers en e-mails.


Wat zeven leveranciers publiceren over de bewaartermijn van session replay-data
Bewaartermijnen van session replay-data vergeleken op basis van de docs van FullStory, Hotjar, Clarity, LogRocket, PostHog, Sentry en Datadog, plus wat de AVG vereist.


Hoeveel vertraagt session replay de snelheid van je website?
Het echte antwoord op de vraag of session replay je website vertraagt, met gepubliceerde cijfers van rrweb en Sentry over scriptgrootte, CPU op de main thread en uploadbandbreedte.


Zo werkt een opt-out voor Google Analytics, en wat elke methode blokkeert
Een opt-out voor Google Analytics kan een browserextensie zijn, een ga-disable-vlag op window of geweigerde toestemming. Wat elke methode blokkeert, wie er de baas over is en waar ze ophoudt.


Waar de data vandaan komt bij session replay vs heatmaps
Session replay vs heatmaps: één bezoek tegenover veel, en hoe Hotjar, Datadog, PostHog, Clarity en FullStory heatmaps bouwen uit opnames, of los ervan.
Gerelateerde artikelen


Zo werkt een samplingpercentage voor session replay in Sentry, PostHog en andere tools
Een samplingpercentage voor session replay bepaalt welk deel van de bezoeken wordt opgenomen. Bekijk hoe Sentry, PostHog, LogRocket, Datadog en Clarity het documenteren.


Wat AVG-compliance voor session replay echt van je vraagt
Een AVG-beoordeling van session replay draait om vier dingen: een rechtsgrond uit artikel 6, bijzondere persoonsgegevens uit artikel 9, toestemming onder artikel 5, lid 3, ePrivacy en een DPIA.


Waar rage clicks en dead clicks echt verschillen
Het verschil tussen rage clicks en dead clicks gaat over de oorzaak, niet over de ernst. Met de detectiedrempels die PostHog, Hotjar, FullStory, LogRocket en Clarity publiceren.

