@d-zero/puppeteer-scroll 4.0.3 → 4.0.4

package/dist/evaluate-with-frame-retry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Max attempts for each `page.evaluate` call when it fails with a transient
+ * frame error. Chrome may briefly swap or re-attach the main frame during a
+ * long scroll or immediately after navigation, even when the target site is
+ * not doing anything observable. Three attempts with a 200 ms gap absorbs
+ * the typical re-attach window without masking a genuinely broken page.
+ */
+export declare const MAX_EVALUATE_RETRIES = 3;
+export declare const DETACHED_RETRY_DELAY_MS = 200;
+/**
+ * Transient errors that occur when `page.evaluate` lands inside Puppeteer's
+ * own frame-swap or session-teardown window. Retrying after a short delay
+ * usually succeeds because the new execution context is then in place.
+ * @param error - Error caught from `page.evaluate`.
+ * @returns `true` when the error is a known transient frame/session error.
+ * @example
+ * ```ts
+ * try {
+ *   await page.evaluate(...);
+ * } catch (error) {
+ *   if (isTransientFrameError(error)) {
+ *     // retry after a short delay
+ *   } else {
+ *     throw error;
+ *   }
+ * }
+ * ```
+ */
+export declare function isTransientFrameError(error: unknown): boolean;
+/**
+ * Retries `evaluator` (typically a `page.evaluate` call) when it fails with
+ * a transient frame error. Non-transient errors are re-thrown immediately.
+ *
+ * Used both inside long-running scroll loops and around the single
+ * `page.evaluate` calls that bracket them, so that Chrome's brief
+ * post-navigation main-frame swap does not surface as an unrecoverable
+ * "Attempted to use detached Frame" error in the caller.
+ * @template T - Evaluator return type.
+ * @param evaluator - Thunk that performs a single `page.evaluate` call.
+ * @returns Whatever `evaluator` returns on success.
+ * @example
+ * ```ts
+ * const scrollHeight = await evaluateWithFrameRetry(() =>
+ *   page.evaluate(() => document.body.scrollHeight),
+ * );
+ * ```
+ */
+export declare function evaluateWithFrameRetry<T>(evaluator: () => Promise<T>): Promise<T>;

package/dist/evaluate-with-frame-retry.js

@@ -0,0 +1,66 @@
+/**
+ * Max attempts for each `page.evaluate` call when it fails with a transient
+ * frame error. Chrome may briefly swap or re-attach the main frame during a
+ * long scroll or immediately after navigation, even when the target site is
+ * not doing anything observable. Three attempts with a 200 ms gap absorbs
+ * the typical re-attach window without masking a genuinely broken page.
+ */
+export const MAX_EVALUATE_RETRIES = 3;
+export const DETACHED_RETRY_DELAY_MS = 200;
+/**
+ * Transient errors that occur when `page.evaluate` lands inside Puppeteer's
+ * own frame-swap or session-teardown window. Retrying after a short delay
+ * usually succeeds because the new execution context is then in place.
+ * @param error - Error caught from `page.evaluate`.
+ * @returns `true` when the error is a known transient frame/session error.
+ * @example
+ * ```ts
+ * try {
+ *   await page.evaluate(...);
+ * } catch (error) {
+ *   if (isTransientFrameError(error)) {
+ *     // retry after a short delay
+ *   } else {
+ *     throw error;
+ *   }
+ * }
+ * ```
+ */
+export function isTransientFrameError(error) {
+    if (!(error instanceof Error))
+        return false;
+    return /Attempted to use detached Frame|Session closed|Execution context was destroyed/i.test(error.message);
+}
+/**
+ * Retries `evaluator` (typically a `page.evaluate` call) when it fails with
+ * a transient frame error. Non-transient errors are re-thrown immediately.
+ *
+ * Used both inside long-running scroll loops and around the single
+ * `page.evaluate` calls that bracket them, so that Chrome's brief
+ * post-navigation main-frame swap does not surface as an unrecoverable
+ * "Attempted to use detached Frame" error in the caller.
+ * @template T - Evaluator return type.
+ * @param evaluator - Thunk that performs a single `page.evaluate` call.
+ * @returns Whatever `evaluator` returns on success.
+ * @example
+ * ```ts
+ * const scrollHeight = await evaluateWithFrameRetry(() =>
+ *   page.evaluate(() => document.body.scrollHeight),
+ * );
+ * ```
+ */
+export async function evaluateWithFrameRetry(evaluator) {
+    let lastError;
+    for (let attempt = 0; attempt < MAX_EVALUATE_RETRIES; attempt++) {
+        try {
+            return await evaluator();
+        }
+        catch (error) {
+            lastError = error;
+            if (!isTransientFrameError(error))
+                throw error;
+            await new Promise((resolve) => setTimeout(resolve, DETACHED_RETRY_DELAY_MS));
+        }
+    }
+    throw lastError;
+}

package/dist/index.d.ts

@@ -1 +1,2 @@
 export { scrollAllOver } from './scroll-all-over.js';
+export { evaluateWithFrameRetry, isTransientFrameError, } from './evaluate-with-frame-retry.js';

package/dist/index.js

@@ -1 +1,2 @@
 export { scrollAllOver } from './scroll-all-over.js';
+export { evaluateWithFrameRetry, isTransientFrameError, } from './evaluate-with-frame-retry.js';

package/dist/scroll-all-over.js

@@ -1,4 +1,5 @@
 import { delay } from '@d-zero/shared/delay';
+import { evaluateWithFrameRetry } from './evaluate-with-frame-retry.js';
 import { resolveValue } from './resolve-value.js';
 /**
  * Number of consecutive iterations without scroll progress before bailing out.
@@ -9,49 +10,6 @@ import { resolveValue } from './resolve-value.js';
  * enough to confirm that scrolling is genuinely blocked.
  */
 const MAX_STUCK_ITERATIONS = 3;
-/**
- * Max attempts for each `page.evaluate` call when it fails with a transient
- * frame error (Chrome may briefly swap or re-attach the main frame during a
- * long scroll, even when the target site is not doing anything observable).
- * Three attempts with a 200 ms gap absorbs the typical re-attach window
- * without masking a genuinely broken page.
- */
-const MAX_EVALUATE_RETRIES = 3;
-const DETACHED_RETRY_DELAY_MS = 200;
-/**
- * Transient errors that occur when `page.evaluate` lands inside Puppeteer's
- * own frame-swap or session-teardown window. Retrying after a short delay
- * usually succeeds because the new execution context is then in place.
- * @param error - Error caught from `page.evaluate`.
- * @returns `true` when the error is a known transient frame/session error.
- */
-function isTransientFrameError(error) {
-    if (!(error instanceof Error))
-        return false;
-    return /Attempted to use detached Frame|Session closed|Execution context was destroyed/i.test(error.message);
-}
-/**
- * Retries `evaluator` (typically a `page.evaluate` call) when it fails with
- * a transient frame error. Non-transient errors are re-thrown immediately.
- * @template T - Evaluator return type.
- * @param evaluator - Thunk that performs a single `page.evaluate` call.
- * @returns Whatever `evaluator` returns on success.
- */
-async function evaluateWithFrameRetry(evaluator) {
-    let lastError;
-    for (let attempt = 0; attempt < MAX_EVALUATE_RETRIES; attempt++) {
-        try {
-            return await evaluator();
-        }
-        catch (error) {
-            lastError = error;
-            if (!isTransientFrameError(error))
-                throw error;
-            await new Promise((resolve) => setTimeout(resolve, DETACHED_RETRY_DELAY_MS));
-        }
-    }
-    throw lastError;
-}
 /**
  * Default interval range (ms) used when `options.interval` is omitted.
  * Randomized to mimic human-like reading pauses while staying close to the

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@d-zero/puppeteer-scroll",
-	"version": "4.0.3",
+	"version": "4.0.4",
 	"description": "Scroll function for puppeteer",
 	"author": "D-ZERO",
 	"license": "MIT",
@@ -36,5 +36,5 @@
 		"url": "https://github.com/d-zero-dev/tools.git",
 		"directory": "packages/@d-zero/puppeteer-scroll"
 	},
-	"gitHead": "d876ace142711051c337f7922931776526047cb0"
+	"gitHead": "9a26e6d8c1e996684691055ffc070547344b21e9"
 }