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

package/README.md

@@ -1,214 +1,41 @@
 # `@d-zero/puppeteer-page-scan`
 
-PuppeteerでスクリーンショットやDOMスキャンする際に必要なヘルパー関数とデバイス設定を提供します。
+Puppeteer でスクリーンショット・DOM スキャン前にビューポート設定・リロード・フック実行・スクロール完了までを行うヘルパー。
 
-## インストール
+## Installation
 
 ```sh
-yarn install @d-zero/puppeteer-page-scan
+yarn add @d-zero/puppeteer-page-scan
 ```
 
-## 使い方
-
-### デバイスプリセット
-
-複数のデバイスサイズ用のプリセットが利用可能です：
+## Usage
 
 ```ts
-import {
-	devicePresets,
-	createSizesFromDevices,
-	parseDevicesOption,
-} from '@d-zero/puppeteer-page-scan';
-
-// 利用可能なデバイスプリセット
-console.log(devicePresets);
-// {
-//   desktop: { width: 1400 },
-//   tablet: { width: 768 },
-//   mobile: { width: 375, resolution: 2 },
-//   'desktop-hd': { width: 1920 },
-//   'desktop-compact': { width: 1280 },
-//   'mobile-large': { width: 414, resolution: 3 },
-//   'mobile-small': { width: 320, resolution: 2 }
-// }
-
-// プリセット名からSizesオブジェクトを生成
-const sizes = createSizesFromDevices(['desktop', 'mobile']);
-
-// CLI用のパーサー（コンマ区切りの文字列から）
-const parsedSizes = parseDevicesOption(['desktop', 'tablet']);
-
-// デフォルトサイズ定数（desktop、tablet、mobileの3種類）
-console.log(defaultSizes);
-// {
-//   desktop: { width: 1400 },
-//   tablet: { width: 768 },
-//   mobile: { width: 375, resolution: 2 }
-// }
-```
-
-### `beforePageScan`
-
-- ビューポートの設定
-- ページのリロード
-- 任意のフック処理
-  - ログインなどの事前処理
-- disclosure要素の展開（オプション）
-  - すべての`<details>`要素を開き、すべての`button[aria-expanded="false"]`要素をクリック
-  - 新しい要素が見つからなくなるまで繰り返し処理（最大1000回）
-  - 各イテレーション後に500ms待機
-  - 最大イテレーション数に達した場合はErrorを投げる
-- ページ全体をスクロール
-
-などを行い、スキャンに必要な状態を整えるためのヘルパー関数です。
-
-```ts
-import { beforePageScan } from '@d-zero/puppeteer-page-scan';
-
-const browser = await puppeteer.launch();
-const page = await browser.newPage();
+import { beforePageScan, readPageHooks } from '@d-zero/puppeteer-page-scan';
 
 await beforePageScan(page, 'https://example.com', {
 	name: 'desktop',
-	width: 1200,
-	resolution: 1,
-	listeners: {
-		setViewport() {},
-		hook() {},
-		load() {},
-		scroll() {},
-	},
-	hooks: [
-		async (page) => {
-			await page.type('#username', 'user');
-			await page.type('#password', 'password');
-			await page.click('button[type="submit"]');
-		},
-	],
-	openDisclosures: true, // オプション: disclosure要素を展開（<details>とbutton[aria-expanded="false"]）
+	width: 1400,
+	openDisclosures: true,
 });
 ```
 
-### `readPageHooks`
-
-ファイルパスの配列からPageHookモジュールを読み込むヘルパー関数です。各パスはESモジュールとしてインポートされ、デフォルトエクスポートを`PageHook`関数として返します。
+### `readPageHooks` — フックモジュールの読み込み
 
 ```ts
-import { readPageHooks } from '@d-zero/puppeteer-page-scan';
-
-// hookファイルのパスからPageHook関数の配列を取得
-const hooks = await readPageHooks(
-	['./hooks/login.js', '/absolute/path/to/hook.js'],
-	process.cwd(), // 相対パスの基準ディレクトリ
-);
+const hooks = await readPageHooks(['./hooks/login.mjs'], process.cwd());
 
-// beforePageScanで使用
-await beforePageScan(page, 'https://example.com', {
-	name: 'desktop',
-	width: 1200,
-	hooks,
-});
+await beforePageScan(page, url, { name: 'desktop', width: 1400, hooks });
 ```
 
-**パラメータ:**
-
-- `hooks`: 読み込むhookファイルのパスの配列（絶対パスまたは相対パス）
-- `baseDir`: 相対パスを解決するための基準ディレクトリ
-
-**戻り値:**
+### 子プロセスを跨ぐ場合は `PageHookSource`
 
-- `Promise<PageHook[]>`: PageHook関数の配列
-
-**エラー:**
-
-- モジュールが見つからない場合は`Error`を投げます
-- デフォルトエクスポートが関数でない場合は`TypeError`を投げます
-
-### `pageScanListener` と `pageScanLoggers`
-
-ページスキャン処理中の各フェーズ（ビューポート設定、ページ読み込み、フック実行、スクロール）のログを出力するためのリスナー関数とロガー設定です。
+IPC は関数を `null` 化するため、親 → 子で `PageHook[]` を直接渡せない。代わりに `PageHookSource`（パスの記述）を IPC で渡し、子プロセス内で `readPageHooks` を呼ぶ。詳細は `src/types.ts` の `PageHookSource` JSDoc。
 
 ```ts
-import { pageScanListener, pageScanLoggers } from '@d-zero/puppeteer-page-scan';
-
-// リスナーを使用（@d-zero/puppeteer-general-actionsのcreateListenerで作成済み）
-const listeners = pageScanListener((message) => {
-	console.log(message);
-});
-
-await beforePageScan(page, 'https://example.com', {
-	name: 'desktop',
-	width: 1200,
-	listeners,
-});
-
-// カスタムロガーを作成する場合
-import { createListener } from '@d-zero/puppeteer-general-actions';
-
-const customListeners = createListener((log) => {
-	const loggers = pageScanLoggers(log);
-	return {
-		...loggers,
-		// 特定のフェーズをカスタマイズ
-		setViewport({ width }) {
-			log(`カスタム: ビューポート幅を${width}pxに変更`);
-		},
-	};
-});
-```
-
-**ログ出力内容:**
-
-- `setViewport`: ビューポートサイズ変更のログ
-- `load`: ページ読み込み（初回/リロード）とタイムアウト情報
-- `hook`: フック実行時のメッセージ
-- `scroll`: スクロール位置と進捗状況（パーセンテージ）
-
-## 型のエクスポート
-
-### `Sizes`
-
-デバイスサイズのマップ型です。キーはデバイス名、値は`Size`オブジェクトです。
-
-```typescript
-type Sizes = Record<string, Size>;
-```
-
-### `Size`
-
-単一デバイスのサイズ設定です。
-
-```typescript
-type Size = {
-	width: number; // ビューポート幅（ピクセル）
-	resolution?: number; // デバイスピクセル比（省略時は1）
-};
-```
-
-### `PageHook`
-
-ページスキャン前に実行されるフック関数の型です。
-
-```typescript
-type PageHook = (
-	page: Page,
-	size: Size & {
-		name: string; // デバイス名
-		log: (message: string) => void; // ログ出力関数
-	},
-) => Promise<void>;
-```
-
-### `PageScanPhase`
-
-ページスキャン処理の各フェーズを表す型です。リスナーのコールバックで使用されます。
+// 親
+const hookSource = { paths: ['./hooks/login.mjs'], baseDir: process.cwd() };
 
-```typescript
-type PageScanPhase = {
-	setViewport: { name: string; width: number; resolution?: number };
-	hook: { name: string; message: string };
-	load: { name: string; type: 'open' | 'reload'; timeout: number; id: string };
-	scroll: { name: string; scrollY: number; scrollHeight: number; message: string };
-};
+// 子
+const hooks = await readPageHooks(hookSource.paths, hookSource.baseDir);
 ```

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.1",
 	"description": "Scanning page function for puppeteer",
 	"author": "D-ZERO",
 	"license": "MIT",
@@ -23,8 +23,9 @@
 		"clean": "tsc --build --clean"
 	},
 	"dependencies": {
-		"@d-zero/puppeteer-general-actions": "1.2.3",
-		"@d-zero/puppeteer-scroll": "3.1.18"
+		"@d-zero/puppeteer-general-actions": "1.2.4",
+		"@d-zero/puppeteer-scroll": "4.0.1",
+		"@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": "25b4043dcd70cf3490ddcefd76a88b22c60f7712"
 }