@d-zero/puppeteer-page-scan 4.4.0 → 4.4.1

package/README.md

@@ -38,6 +38,14 @@ 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`
@@ -81,3 +89,126 @@ await beforePageScan(page, 'https://example.com', {
 	openDisclosures: true, // オプション: disclosure要素を展開（<details>とbutton[aria-expanded="false"]）
 });
 ```
+
+### `readPageHooks`
+
+ファイルパスの配列からPageHookモジュールを読み込むヘルパー関数です。各パスはESモジュールとしてインポートされ、デフォルトエクスポートを`PageHook`関数として返します。
+
+```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(), // 相対パスの基準ディレクトリ
+);
+
+// beforePageScanで使用
+await beforePageScan(page, 'https://example.com', {
+	name: 'desktop',
+	width: 1200,
+	hooks,
+});
+```
+
+**パラメータ:**
+
+- `hooks`: 読み込むhookファイルのパスの配列（絶対パスまたは相対パス）
+- `baseDir`: 相対パスを解決するための基準ディレクトリ
+
+**戻り値:**
+
+- `Promise<PageHook[]>`: PageHook関数の配列
+
+**エラー:**
+
+- モジュールが見つからない場合は`Error`を投げます
+- デフォルトエクスポートが関数でない場合は`TypeError`を投げます
+
+### `pageScanListener` と `pageScanLoggers`
+
+ページスキャン処理中の各フェーズ（ビューポート設定、ページ読み込み、フック実行、スクロール）のログを出力するためのリスナー関数とロガー設定です。
+
+```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`
+
+ページスキャン処理の各フェーズを表す型です。リスナーのコールバックで使用されます。
+
+```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 };
+};
+```

package/dist/before-page-scan.js

@@ -71,7 +71,7 @@ export async function beforePageScan(page, url, options) {
         deviceScaleFactor: resolution ?? 1,
     });
     if (page.url() === url) {
-        listener?.('load', { name, type: 'reaload', timeout, id: countDownId });
+        listener?.('load', { name, type: 'reload', timeout, id: countDownId });
         await navigateWithFallback(page, url, timeout, true, listener, name);
     }
     else {

package/dist/types.d.ts

@@ -20,7 +20,7 @@ export type PageScanPhase = {
     };
     load: {
         name: string;
-        type: 'open' | 'reaload';
+        type: 'open' | 'reload';
         timeout: number;
         id: string;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@d-zero/puppeteer-page-scan",
-	"version": "4.4.0",
+	"version": "4.4.1",
 	"description": "Scanning page function for puppeteer",
 	"author": "D-ZERO",
 	"license": "MIT",
@@ -23,14 +23,14 @@
 		"clean": "tsc --build --clean"
 	},
 	"dependencies": {
-		"@d-zero/puppeteer-general-actions": "1.2.1",
-		"@d-zero/puppeteer-scroll": "3.1.8"
+		"@d-zero/puppeteer-general-actions": "1.2.2",
+		"@d-zero/puppeteer-scroll": "3.1.9"
 	},
 	"devDependencies": {
-		"puppeteer": "24.36.0"
+		"puppeteer": "24.37.1"
 	},
 	"peerDependencies": {
-		"puppeteer": "24.36.0"
+		"puppeteer": "24.37.1"
 	},
-	"gitHead": "e2189e6878674b8fef5fa3c121ad109c448040fe"
+	"gitHead": "008ea25926579b061e36c1f5f4f4fc7e15cb782e"
 }