From 2bca8505435cf170edbb81a45e7c62a4566454fa Mon Sep 17 00:00:00 2001
From: Yun Feng <f18846188605@gmail.com>
Date: Wed, 1 Apr 2026 12:00:00 +0800
Subject: [PATCH] disable smooth scroll behavior in sync mode (#824)

---
 packages/rrweb/src/replay/index.ts | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/packages/rrweb/src/replay/index.ts b/packages/rrweb/src/replay/index.ts
index 3b1a9a7e..bfa85ee9 100644
--- a/packages/rrweb/src/replay/index.ts
+++ b/packages/rrweb/src/replay/index.ts
@@ -183,7 +183,7 @@ export class Replayer {
       this.virtualStyleRulesMap.clear();
 
       for (const d of scrollMap.values()) {
-        this.applyScroll(d);
+        this.applyScroll(d, true);
       }
       for (const d of inputMap.values()) {
         this.applyInput(d);
@@ -985,7 +985,7 @@ export class Replayer {
           this.treeIndex.scroll(d);
           break;
         }
-        this.applyScroll(d);
+        this.applyScroll(d, false);
         break;
       }
       case IncrementalSource.ViewportResize:
@@ -1598,7 +1598,13 @@ export class Replayer {
     });
   }
 
-  private applyScroll(d: scrollData) {
+  /**
+   * Apply the scroll data on real elements.
+   * If the replayer is in sync mode, smooth scroll behavior should be disabled.
+   * @param d the scroll data
+   * @param isSync whether the replayer is in sync mode(fast-forward)
+   */
+  private applyScroll(d: scrollData, isSync: boolean) {
     const target = this.mirror.getNode(d.id);
     if (!target) {
       return this.debugNodeNotFound(d, d.id);
@@ -1607,14 +1613,14 @@ export class Replayer {
       this.iframe.contentWindow!.scrollTo({
         top: d.y,
         left: d.x,
-        behavior: 'smooth',
+        behavior: isSync ? 'auto' : 'smooth',
       });
     } else if (target.__sn.type === NodeType.Document) {
       // nest iframe content document
       ((target as unknown) as Document).defaultView!.scrollTo({
         top: d.y,
         left: d.x,
-        behavior: 'smooth',
+        behavior: isSync ? 'auto' : 'smooth',
       });
     } else {
       try {