@d-zero/puppeteer-page-scan 4.4.10 → 4.5.0

package/README.md

@@ -87,9 +87,20 @@ await beforePageScan(page, 'https://example.com', {
 		},
 	],
 	openDisclosures: true, // オプション: disclosure要素を展開（<details>とbutton[aria-expanded="false"]）
+	scrollInterval: { random: { min: 200, max: 500 } }, // オプション: スクロール間隔（ms）
+	scrollDistance: { random: { min: 300, max: 900 } }, // オプション: 1ステップで進む距離（px）
 });
 ```
 
+#### スクロールオプション
+
+| オプション       | 型                       | 説明                                                                                                                                                |
+| ---------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `scrollInterval` | `number \| DelayOptions` | `scrollAllOver`の`interval`にそのまま渡されます。未指定時は[`@d-zero/puppeteer-scroll`](../puppeteer-scroll/README.md#デフォルト挙動)のデフォルト。 |
+| `scrollDistance` | `number \| DelayOptions` | `scrollAllOver`の`distance`にそのまま渡されます。未指定時は同上。                                                                                   |
+
+詳細は[`@d-zero/puppeteer-scroll`](../puppeteer-scroll/README.md#api)を参照。
+
 ### `readPageHooks`
 
 ファイルパスの配列からPageHookモジュールを読み込むヘルパー関数です。各パスはESモジュールとしてインポートされ、デフォルトエクスポートを`PageHook`関数として返します。
@@ -125,6 +136,22 @@ await beforePageScan(page, 'https://example.com', {
 - モジュールが見つからない場合は`Error`を投げます
 - デフォルトエクスポートが関数でない場合は`TypeError`を投げます
 
+#### 子プロセスを経由する場合の使い分け
+
+Node の IPC（`process.send`）は関数を JSON 化できず `null` に変換するため、`PageHook[]`（関数配列）を親プロセスから子プロセスへ直接渡すことはできません。`@d-zero/print` / `@d-zero/archaeologist` / `@d-zero/a11y-check` のように `@d-zero/puppeteer-dealer` を経由して子プロセスでフックを実行する場合は、**パスの記述（[`PageHookSource`](#pagehooksource)）を子プロセスに渡し、子プロセス内で `readPageHooks` を呼ぶ**設計にしてください。
+
+```ts
+// 親プロセス: PageHookSource を組み立てて IPC で渡す
+const hookSource = {
+	paths: ['./hooks/login.mjs'],
+	baseDir: process.cwd(),
+};
+
+// 子プロセス: 受け取ったパスから関数化して beforePageScan に渡す
+const hooks = await readPageHooks(hookSource.paths, hookSource.baseDir);
+await beforePageScan(page, url, { name, width, hooks });
+```
+
 ### `pageScanListener` と `pageScanLoggers`
 
 ページスキャン処理中の各フェーズ（ビューポート設定、ページ読み込み、フック実行、スクロール）のログを出力するためのリスナー関数とロガー設定です。
@@ -200,6 +227,19 @@ type PageHook = (
 ) => Promise<void>;
 ```
 
+### `PageHookSource`
+
+子プロセスにフックをIPCで渡すための「ロード元の記述」を表す型です。Node IPC は関数を `null` 化するため、`PageHook[]`（関数配列）を親→子で直接渡せません。`@d-zero/puppeteer-dealer` を経由するツールはこの形で受け渡しを行い、子プロセス内で `readPageHooks` を呼んで関数化します。
+
+```typescript
+type PageHookSource = {
+	readonly paths: readonly string[]; // フックファイルのパス（絶対 or 相対）
+	readonly baseDir: string; // 相対パスを解決する基準ディレクトリ
+};
+```
+
+使い方は [子プロセスを経由する場合の使い分け](#子プロセスを経由する場合の使い分け) を参照してください。
+
 ### `PageScanPhase`
 
 ページスキャン処理の各フェーズを表す型です。リスナーのコールバックで使用されます。

package/dist/before-page-scan.d.ts

@@ -1,5 +1,6 @@
 import type { PageHook, PageScanPhase, Size } from './types.js';
 import type { Listener } from '@d-zero/puppeteer-general-actions';
+import type { DelayOptions } from '@d-zero/shared/delay';
 import type { Page } from 'puppeteer';
 type Options = {
     name: string;
@@ -7,6 +8,8 @@ type Options = {
     listener?: Listener<PageScanPhase>;
     timeout?: number;
     openDisclosures?: boolean;
+    scrollInterval?: number | DelayOptions;
+    scrollDistance?: number | DelayOptions;
 } & Size;
 /**
  *

package/dist/before-page-scan.js

@@ -101,6 +101,8 @@ export async function beforePageScan(page, url, options) {
         message: 'Start scrolling',
     });
     await scrollAllOver(page, {
+        interval: options?.scrollInterval,
+        distance: options?.scrollDistance,
         logger: (scrollY, scrollHeight, message) => listener?.('scroll', { name, scrollY, scrollHeight, message }),
     });
 }

package/dist/types.d.ts

@@ -8,6 +8,15 @@ export type PageHook = (page: Page, size: Size & {
     name: string;
     log: (message: string) => void;
 }) => Promise<void>;
+/**
+ * 子プロセスにフックをIPCで渡すための「ロード元の記述」。
+ * 親プロセスではこの形のまま保持し、子プロセスで `readPageHooks(paths, baseDir)`
+ * を呼んで関数化する。Node IPC は関数を `null` 化するため、関数配列を直接渡せない。
+ */
+export type PageHookSource = {
+    readonly paths: readonly string[];
+    readonly baseDir: string;
+};
 export type PageScanPhase = {
     setViewport: {
         name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@d-zero/puppeteer-page-scan",
-	"version": "4.4.10",
+	"version": "4.5.0",
 	"description": "Scanning page function for puppeteer",
 	"author": "D-ZERO",
 	"license": "MIT",
@@ -24,7 +24,8 @@
 	},
 	"dependencies": {
 		"@d-zero/puppeteer-general-actions": "1.2.3",
-		"@d-zero/puppeteer-scroll": "3.1.18"
+		"@d-zero/puppeteer-scroll": "4.0.0",
+		"@d-zero/shared": "0.22.0"
 	},
 	"devDependencies": {
 		"puppeteer": "24.37.5"
@@ -37,5 +38,5 @@
 		"url": "https://github.com/d-zero-dev/tools.git",
 		"directory": "packages/@d-zero/puppeteer-page-scan"
 	},
-	"gitHead": "611614bdfcdfe3ef872efd01a1fd31ebedffdbb2"
+	"gitHead": "2d24e08c0cb516b7ea9d07a4301eb991193cca11"
 }