Woordenlijst

Wat rrweb vastlegt en hoe de privacyopties werken

Taras Shynkarenko
Taras Shynkarenko
•Bijgewerkt: •8 min leestijd
Wat rrweb vastlegt en hoe de privacyopties werkenWat rrweb vastlegt en hoe de privacyopties werken

TL;DR, kort antwoord

8 min leestijd

De 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.

PakketWat het doet
@rrweb/recordDe opnamecode, bedoeld om in je front-end-app of pagina te draaien
@rrweb/replayBouwt opgenomen events opnieuw op en speelt ze af in een iframe
@rrweb/allOpnemen, afspelen en de packer in één pakket, zonder plug-ins
rrweb-playerEen afspeelinterface met pauzeren, vooruitspoelen en zoeken, gebouwd op @rrweb/replay
rrweb-snapshotSerialiseert de DOM en bouwt hem opnieuw op, de basis van het event FullSnapshot
@rrweb/packerCompressie per event vóór verzending over het netwerk
@rrweb/types, @rrweb/utilsGedeelde types en hulpfuncties
rrdom, rrdom-nodejsEen virtuele DOM om mutaties tijdens het afspelen snel door te spoelen, plus een Node.js-versie
rrvideoZet een opname om in een video
rrwebHet 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.

OptieStandaardWat het doet
blockClass'rr-block'Elementen om te blokkeren, als string of RegExp
blockSelectornullEen selector voor elementen om te blokkeren
ignoreClass'rr-ignore'Elementen waarvan invoerevents worden genegeerd, als string of RegExp
ignoreSelectornullEen selector voor elementen om te negeren
maskTextClass'rr-mask'Elementen waarvan de tekst wordt gemaskeerd, als string of RegExp
maskTextSelectornullEen selector voor elementen om te maskeren
maskAllInputsfalseMaskeert alle invoer als *
maskInputOptions{ password: true }Maskeert bepaalde soorten invoer
maskInputFngeenEigen logica voor het maskeren van invoer
maskTextFngeenEigen logica voor het maskeren van tekst
ignoreCSSAttributesnullEen array met CSS-attributen om te negeren
recordCanvasfalseOf canvas-elementen worden opgenomen
recordCrossOriginIframesfalseOf 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.

Handen die typen op een laptoptoetsenbord, als beeld van de formulierinvoer die rrweb opneemt tenzij je die maskeert.

Drie privacyklassen, drie effecten
blockClassHaalt het element weg, speelt een placeholder af
ignoreClassHoudt het element, laat de invoerevents vallen
maskTextClassHoudt het element, vervangt de tekst
Elke klasse in de tabel Record Options van rrweb verandert een ander deel van de opname.

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 }.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

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.

Rijen serverracks in een datacenter, waar rrweb-opnames zich opstapelen en opslag innemen.

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.

Flowsery
Flowsery

Start je gratis proefperiode van 14 dagen

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

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 zienZo werkt session replay, en dit kan het niet zien
Woordenlijst

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.

•7 min leestijd
Waar de standaardinstellingen voor PII-redactie in sessiereplay data blootleggenWaar de standaardinstellingen voor PII-redactie in sessiereplay data blootleggen
Woordenlijst

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.

•9 min leestijd
Wat zeven leveranciers publiceren over de bewaartermijn van session replay-dataWat zeven leveranciers publiceren over de bewaartermijn van session replay-data
Woordenlijst

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.

•8 min leestijd
Hoeveel vertraagt session replay de snelheid van je website?Hoeveel vertraagt session replay de snelheid van je website?
Woordenlijst

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.

•8 min leestijd
Zo werkt een opt-out voor Google Analytics, en wat elke methode blokkeertZo werkt een opt-out voor Google Analytics, en wat elke methode blokkeert
Woordenlijst

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.

•8 min leestijd
Waar de data vandaan komt bij session replay vs heatmapsWaar de data vandaan komt bij session replay vs heatmaps
Woordenlijst

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.

•7 min leestijd

Gerelateerde artikelen