@tocha688/browser 0.0.1 → 1.0.0

package/src/human/mouse.ts

@@ -1,308 +1,308 @@
-// const { Bezier } = require('bezier-js');
-// const { sleep } = require('timers/promises');
-import { sleep } from '@tocha688/utils';
-import { rInt } from '@tocha688/utils/random';
-import { Bezier } from 'bezier-js';
-import type { Locator, Page } from 'patchright-core';
-
-/** 坐标点定义 */
-type Point = {
-    /** X坐标 */
-    x: number;
-    /** Y坐标 */
-    y: number;
-};
-
-/** 范围定义，用于指定元素内的随机点范围 */
-type Range = {
-    /** 最小边界比例 (0-1) */
-    min?: number;
-    /** 最大边界比例 (0-1) */
-    max?: number;
-};
-
-/** 鼠标移动配置 */
-type Config = {
-    /** 最小移动步数 */
-    minSteps: number;
-    /** 最大移动步数 */
-    maxSteps: number;
-};
-
-/** 延迟和移动选项 */
-type DelayOptions = {
-    /** 移动步数，覆盖默认配置 */
-    steps?: number;
-    /** 移动速度 (0-1)，越大越快 */
-    speed?: number;
-    /** 随机性 (0-1)，越大路径越随机 */
-    randomness?: number;
-};
-
-/** 移动到元素的选项，结合了延迟选项和范围选项 */
-type MoveOptions = DelayOptions & Range;
-
-/** 鼠标按键类型 */
-type MouseButton = 'left' | 'right' | 'middle';
-
-/** 点击选项 */
-export type ClickOptions = DelayOptions & {
-    /** 是否执行双击 */
-    doubleClick?: boolean;
-    /** 鼠标按键 */
-    button?: MouseButton;
-};
-
-/** 点击元素的选项，结合了点击选项和范围选项 */
-type ClickElementOptions = ClickOptions & Range;
-
-/**
- * 模拟真人鼠标移动和点击的类
- * 使用贝塞尔曲线生成自然的鼠标轨迹，避免被检测为机器人
- */
-export class HumanMouse {
-    /** Playwright页面实例 */
-    page: Page;
-    /** 当前鼠标位置 */
-    currentPosition: Point = { x: 0, y: 0 };
-    /** 移动配置 */
-    config: Config = { minSteps: 15, maxSteps: 50 };
-
-    /**
-     * 构造函数
-     * @param page Playwright页面实例
-     * @param config 可选的配置参数
-     */
-    constructor(page: Page, config: Partial<Config> = {}) {
-        this.page = page;
-        this.currentPosition = { x: 0, y: 0 };
-        this.config = {
-            minSteps: 15,
-            maxSteps: 50,
-            ...config
-        };
-    }
-
-    /**
-     * 生成随机步数
-     * @returns 在配置范围内的随机步数
-     */
-    private _randomSteps(): number {
-        return Math.floor(Math.random() *
-            (this.config.maxSteps - this.config.minSteps)) + this.config.minSteps;
-    }
-
-    /**
-     * 计算元素内的随机点
-     * @param el 目标元素
-     * @param options 范围选项
-     * @returns 元素内的随机坐标点
-     */
-    private async _toPoint(el: Locator, options?: Range): Promise<Point> {
-        const { min = 0.2, max = 0.8 } = options || {};
-        const box = await el.boundingBox();
-        if (!box) {
-            throw new Error('Element has no bounding box');
-        }
-        return {
-            x: box.x + box.width * (min + (Math.random() * (max - min))),
-            y: box.y + box.height * (min + (Math.random() * (max - min)))
-        };
-    }
-
-    /**
-     * 模拟真人鼠标绝对移动
-     * @param x 目标X坐标
-     * @param y 目标Y坐标
-     * @param options 移动选项
-     */
-    async moveTo(x: number, y: number, options: DelayOptions = {}): Promise<void> {
-        const { speed = 0.5, randomness = 0.3 } = options;
-        const start = this.currentPosition;
-        const end = { x, y };
-        // 生成贝塞尔曲线控制点
-        const controlPoints = this.generateControlPoints(start, end, randomness);
-        //@ts-ignore
-        const curve = new Bezier(...controlPoints);
-        const steps = options.steps || this._randomSteps();
-        const points = curve.getLUT(steps);
-
-        for (let i = 0; i < points.length; i++) {
-            const point = points[i] as Point;
-            const delay = this.getDynamicDelay(i, points.length, speed);
-
-            await this.page.mouse.move(point.x, point.y);
-            await sleep(delay);
-        }
-        this.currentPosition = end;
-    }
-
-    /**
-     * 模拟真人鼠标移动到指定元素
-     * @param el 目标元素
-     * @param options 移动和范围选项
-     */
-    async moveToEl(el: Locator, options: MoveOptions = {}): Promise<void> {
-        const point = await this._toPoint(el, options);
-        await this.moveTo(point.x, point.y, options);
-    }
-
-    /**
-     * 模拟真人鼠标相对移动
-     * @param deltaX X轴偏移量
-     * @param deltaY Y轴偏移量
-     * @param options 移动和范围选项
-     */
-    async moveBy(deltaX: number, deltaY: number, options: MoveOptions = {}): Promise<void> {
-        const targetX = this.currentPosition.x + deltaX;
-        const targetY = this.currentPosition.y + deltaY;
-        return this.moveTo(targetX, targetY, options);
-    }
-
-    async scrollBy(deltaY: number, options: DelayOptions = {}): Promise<void> {
-        const { speed = 0.5, randomness = 0.3 } = options;
-        const steps = options.steps || this._randomSteps();
-        const baseStep = deltaY / steps;
-        for (let i = 0; i < steps; i++) {
-            const jitter = baseStep * (Math.random() - 0.5) * randomness;
-            const stepY = baseStep + jitter;
-            //@ts-ignore
-            await this.page.evaluate(`(y) => { window.scrollBy(0, y); }`, stepY);
-            const delay = this.getDynamicDelay(i, steps, speed);
-            await sleep(delay);
-        }
-    }
-
-    async scrollTo(y: number, options: DelayOptions = {}): Promise<void> {
-        const current = await this.page.evaluate(`() => window.scrollY || document.documentElement.scrollTop || 0`) as number;
-        const delta = y - current;
-        if (Math.abs(delta) < 1) return;
-        await this.scrollBy(delta, options);
-    }
-
-    async scrollToEl(el: Locator, options: DelayOptions = {}): Promise<void> {
-        const viewport = this.page.viewportSize();
-        //@ts-ignore
-        const viewportHeight = viewport?.height ?? await this.page.evaluate(`() => window.innerHeight`) as any;
-        const metrics = await el.evaluate(`(node) => {
-            const rect = node.getBoundingClientRect();
-            return { top: rect.top + window.scrollY, height: rect.height };
-        }`) as any;
-        const target = Math.max(0, metrics.top - viewportHeight * 0.3);
-        await this.scrollTo(target, options);
-    }
-
-    /**
-     * 模拟真人鼠标单击
-     * @param x 目标X坐标
-     * @param y 目标Y坐标
-     * @param options 点击选项
-     */
-    async click(x: number, y: number, options: ClickOptions = {}): Promise<void> {
-        const { doubleClick = false, button = 'left' } = options;
-        await this.moveTo(x, y, {
-            steps: options.steps,
-            speed: options.speed,
-            randomness: options.randomness
-        });
-        await this.page.mouse.down({ button });
-        await sleep(rInt(50, 150));
-        await this.page.mouse.up({ button });
-
-        if (doubleClick) {
-            await sleep(rInt(100, 300));
-            await this.page.mouse.down({ button });
-            await sleep(rInt(50, 150));
-            await this.page.mouse.up({ button });
-        }
-    }
-
-    /**
-     * 模拟真人鼠标单击指定元素
-     * @param el 目标元素
-     * @param options 点击和范围选项
-     */
-    async clickEl(el: Locator, options: ClickElementOptions = {}): Promise<void> {
-        try {
-            const point = await this._toPoint(el, options);
-            await this.click(point.x, point.y, options);
-        } catch (err) {
-            console.log('clickEl err: ', err, 'el: ', el);
-        }
-    }
-
-    /**
-     * 生成贝塞尔曲线控制点
-     * @param start 起始点
-     * @param end 终点
-     * @param randomness 随机性程度
-     * @returns 四个控制点组成的数组
-     */
-    generateControlPoints(start: Point, end: Point, randomness: number): Point[] {
-        const distance = Math.hypot(end.x - start.x, end.y - start.y);
-        const cp1 = {
-            x: start.x + (end.x - start.x) * 0.3 + (Math.random() - 0.5) * distance * randomness,
-            y: start.y + (end.y - start.y) * 0.3 + (Math.random() - 0.5) * distance * randomness
-        };
-        const cp2 = {
-            x: end.x - (end.x - start.x) * 0.3 + (Math.random() - 0.5) * distance * randomness,
-            y: end.y - (end.y - start.y) * 0.3 + (Math.random() - 0.5) * distance * randomness
-        };
-        return [start, cp1, cp2, end];
-    }
-
-    /**
-     * 计算动态延迟，模拟加速减速效果
-     * @param index 当前步骤索引
-     * @param totalPoints 总步数
-     * @param speed 速度参数
-     * @returns 延迟时间（毫秒）
-     */
-    getDynamicDelay(index: number, totalPoints: number, speed: number): number {
-        // 模拟加速减速效果
-        const progress = index / totalPoints;
-        const baseDelay = 10 + (1 - speed) * 50;
-        return Math.max(10, baseDelay * (1 - Math.sin(progress * Math.PI)) * 0.5);
-    }
-
-    /**
-     * 生成指定范围内的随机延迟
-     * @param min 最小延迟（毫秒）
-     * @param max 最大延迟（毫秒）
-     * @returns 随机延迟时间（毫秒）
-     */
-    getRandomDelay(min = 20, max = 100): number {
-        return Math.floor(Math.random() * (max - min + 1)) + min;
-    }
-
-    /**
-     * 在页面上显示鼠标轨迹，用于调试
-     * 会在页面上添加一个红色小点跟随鼠标移动
-     */
-    async showCursor(): Promise<void> {
-        await this.page.addInitScript({
-            content: `
-                let dot;
-                document.addEventListener('mousemove', (e) => {
-                    if (!dot) {
-                        dot = document.createElement('div');
-                        Object.assign(dot.style, {
-                            position: 'fixed',
-                            width: '5px',
-                            height: '5px',
-                            borderRadius: '50%',
-                            backgroundColor: 'red',
-                            pointerEvents: 'none',
-                            zIndex: 999999
-                        });
-                        document.body.appendChild(dot);
-                    }
-                    dot.style.left = e.clientX + 'px';
-                    dot.style.top = e.clientY + 'px';
-                });
-            `
-        });
-    }
-}
-
-export default HumanMouse;
+// const { Bezier } = require('bezier-js');
+// const { sleep } = require('timers/promises');
+import { sleep } from '@tocha688/utils';
+import { rInt } from '@tocha688/utils/random';
+import { Bezier } from 'bezier-js';
+import type { Locator, Page } from 'patchright-core';
+
+/** 坐标点定义 */
+type Point = {
+    /** X坐标 */
+    x: number;
+    /** Y坐标 */
+    y: number;
+};
+
+/** 范围定义，用于指定元素内的随机点范围 */
+type Range = {
+    /** 最小边界比例 (0-1) */
+    min?: number;
+    /** 最大边界比例 (0-1) */
+    max?: number;
+};
+
+/** 鼠标移动配置 */
+type Config = {
+    /** 最小移动步数 */
+    minSteps: number;
+    /** 最大移动步数 */
+    maxSteps: number;
+};
+
+/** 延迟和移动选项 */
+type DelayOptions = {
+    /** 移动步数，覆盖默认配置 */
+    steps?: number;
+    /** 移动速度 (0-1)，越大越快 */
+    speed?: number;
+    /** 随机性 (0-1)，越大路径越随机 */
+    randomness?: number;
+};
+
+/** 移动到元素的选项，结合了延迟选项和范围选项 */
+type MoveOptions = DelayOptions & Range;
+
+/** 鼠标按键类型 */
+type MouseButton = 'left' | 'right' | 'middle';
+
+/** 点击选项 */
+export type ClickOptions = DelayOptions & {
+    /** 是否执行双击 */
+    doubleClick?: boolean;
+    /** 鼠标按键 */
+    button?: MouseButton;
+};
+
+/** 点击元素的选项，结合了点击选项和范围选项 */
+type ClickElementOptions = ClickOptions & Range;
+
+/**
+ * 模拟真人鼠标移动和点击的类
+ * 使用贝塞尔曲线生成自然的鼠标轨迹，避免被检测为机器人
+ */
+export class HumanMouse {
+    /** Playwright页面实例 */
+    page: Page;
+    /** 当前鼠标位置 */
+    currentPosition: Point = { x: 0, y: 0 };
+    /** 移动配置 */
+    config: Config = { minSteps: 15, maxSteps: 50 };
+
+    /**
+     * 构造函数
+     * @param page Playwright页面实例
+     * @param config 可选的配置参数
+     */
+    constructor(page: Page, config: Partial<Config> = {}) {
+        this.page = page;
+        this.currentPosition = { x: 0, y: 0 };
+        this.config = {
+            minSteps: 15,
+            maxSteps: 50,
+            ...config
+        };
+    }
+
+    /**
+     * 生成随机步数
+     * @returns 在配置范围内的随机步数
+     */
+    private _randomSteps(): number {
+        return Math.floor(Math.random() *
+            (this.config.maxSteps - this.config.minSteps)) + this.config.minSteps;
+    }
+
+    /**
+     * 计算元素内的随机点
+     * @param el 目标元素
+     * @param options 范围选项
+     * @returns 元素内的随机坐标点
+     */
+    private async _toPoint(el: Locator, options?: Range): Promise<Point> {
+        const { min = 0.2, max = 0.8 } = options || {};
+        const box = await el.boundingBox();
+        if (!box) {
+            throw new Error('Element has no bounding box');
+        }
+        return {
+            x: box.x + box.width * (min + (Math.random() * (max - min))),
+            y: box.y + box.height * (min + (Math.random() * (max - min)))
+        };
+    }
+
+    /**
+     * 模拟真人鼠标绝对移动
+     * @param x 目标X坐标
+     * @param y 目标Y坐标
+     * @param options 移动选项
+     */
+    async moveTo(x: number, y: number, options: DelayOptions = {}): Promise<void> {
+        const { speed = 0.5, randomness = 0.3 } = options;
+        const start = this.currentPosition;
+        const end = { x, y };
+        // 生成贝塞尔曲线控制点
+        const controlPoints = this.generateControlPoints(start, end, randomness);
+        //@ts-ignore
+        const curve = new Bezier(...controlPoints);
+        const steps = options.steps || this._randomSteps();
+        const points = curve.getLUT(steps);
+
+        for (let i = 0; i < points.length; i++) {
+            const point = points[i] as Point;
+            const delay = this.getDynamicDelay(i, points.length, speed);
+
+            await this.page.mouse.move(point.x, point.y);
+            await sleep(delay);
+        }
+        this.currentPosition = end;
+    }
+
+    /**
+     * 模拟真人鼠标移动到指定元素
+     * @param el 目标元素
+     * @param options 移动和范围选项
+     */
+    async moveToEl(el: Locator, options: MoveOptions = {}): Promise<void> {
+        const point = await this._toPoint(el, options);
+        await this.moveTo(point.x, point.y, options);
+    }
+
+    /**
+     * 模拟真人鼠标相对移动
+     * @param deltaX X轴偏移量
+     * @param deltaY Y轴偏移量
+     * @param options 移动和范围选项
+     */
+    async moveBy(deltaX: number, deltaY: number, options: MoveOptions = {}): Promise<void> {
+        const targetX = this.currentPosition.x + deltaX;
+        const targetY = this.currentPosition.y + deltaY;
+        return this.moveTo(targetX, targetY, options);
+    }
+
+    async scrollBy(deltaY: number, options: DelayOptions = {}): Promise<void> {
+        const { speed = 0.5, randomness = 0.3 } = options;
+        const steps = options.steps || this._randomSteps();
+        const baseStep = deltaY / steps;
+        for (let i = 0; i < steps; i++) {
+            const jitter = baseStep * (Math.random() - 0.5) * randomness;
+            const stepY = baseStep + jitter;
+            //@ts-ignore
+            await this.page.evaluate(`(y) => { window.scrollBy(0, y); }`, stepY);
+            const delay = this.getDynamicDelay(i, steps, speed);
+            await sleep(delay);
+        }
+    }
+
+    async scrollTo(y: number, options: DelayOptions = {}): Promise<void> {
+        const current = await this.page.evaluate(`() => window.scrollY || document.documentElement.scrollTop || 0`) as number;
+        const delta = y - current;
+        if (Math.abs(delta) < 1) return;
+        await this.scrollBy(delta, options);
+    }
+
+    async scrollToEl(el: Locator, options: DelayOptions = {}): Promise<void> {
+        const viewport = this.page.viewportSize();
+        //@ts-ignore
+        const viewportHeight = viewport?.height ?? await this.page.evaluate(`() => window.innerHeight`) as any;
+        const metrics = await el.evaluate(`(node) => {
+            const rect = node.getBoundingClientRect();
+            return { top: rect.top + window.scrollY, height: rect.height };
+        }`) as any;
+        const target = Math.max(0, metrics.top - viewportHeight * 0.3);
+        await this.scrollTo(target, options);
+    }
+
+    /**
+     * 模拟真人鼠标单击
+     * @param x 目标X坐标
+     * @param y 目标Y坐标
+     * @param options 点击选项
+     */
+    async click(x: number, y: number, options: ClickOptions = {}): Promise<void> {
+        const { doubleClick = false, button = 'left' } = options;
+        await this.moveTo(x, y, {
+            steps: options.steps,
+            speed: options.speed,
+            randomness: options.randomness
+        });
+        await this.page.mouse.down({ button });
+        await sleep(rInt(50, 150));
+        await this.page.mouse.up({ button });
+
+        if (doubleClick) {
+            await sleep(rInt(100, 300));
+            await this.page.mouse.down({ button });
+            await sleep(rInt(50, 150));
+            await this.page.mouse.up({ button });
+        }
+    }
+
+    /**
+     * 模拟真人鼠标单击指定元素
+     * @param el 目标元素
+     * @param options 点击和范围选项
+     */
+    async clickEl(el: Locator, options: ClickElementOptions = {}): Promise<void> {
+        try {
+            const point = await this._toPoint(el, options);
+            await this.click(point.x, point.y, options);
+        } catch (err) {
+            console.log('clickEl err: ', err, 'el: ', el);
+        }
+    }
+
+    /**
+     * 生成贝塞尔曲线控制点
+     * @param start 起始点
+     * @param end 终点
+     * @param randomness 随机性程度
+     * @returns 四个控制点组成的数组
+     */
+    generateControlPoints(start: Point, end: Point, randomness: number): Point[] {
+        const distance = Math.hypot(end.x - start.x, end.y - start.y);
+        const cp1 = {
+            x: start.x + (end.x - start.x) * 0.3 + (Math.random() - 0.5) * distance * randomness,
+            y: start.y + (end.y - start.y) * 0.3 + (Math.random() - 0.5) * distance * randomness
+        };
+        const cp2 = {
+            x: end.x - (end.x - start.x) * 0.3 + (Math.random() - 0.5) * distance * randomness,
+            y: end.y - (end.y - start.y) * 0.3 + (Math.random() - 0.5) * distance * randomness
+        };
+        return [start, cp1, cp2, end];
+    }
+
+    /**
+     * 计算动态延迟，模拟加速减速效果
+     * @param index 当前步骤索引
+     * @param totalPoints 总步数
+     * @param speed 速度参数
+     * @returns 延迟时间（毫秒）
+     */
+    getDynamicDelay(index: number, totalPoints: number, speed: number): number {
+        // 模拟加速减速效果
+        const progress = index / totalPoints;
+        const baseDelay = 10 + (1 - speed) * 50;
+        return Math.max(10, baseDelay * (1 - Math.sin(progress * Math.PI)) * 0.5);
+    }
+
+    /**
+     * 生成指定范围内的随机延迟
+     * @param min 最小延迟（毫秒）
+     * @param max 最大延迟（毫秒）
+     * @returns 随机延迟时间（毫秒）
+     */
+    getRandomDelay(min = 20, max = 100): number {
+        return Math.floor(Math.random() * (max - min + 1)) + min;
+    }
+
+    /**
+     * 在页面上显示鼠标轨迹，用于调试
+     * 会在页面上添加一个红色小点跟随鼠标移动
+     */
+    async showCursor(): Promise<void> {
+        await this.page.addInitScript({
+            content: `
+                let dot;
+                document.addEventListener('mousemove', (e) => {
+                    if (!dot) {
+                        dot = document.createElement('div');
+                        Object.assign(dot.style, {
+                            position: 'fixed',
+                            width: '5px',
+                            height: '5px',
+                            borderRadius: '50%',
+                            backgroundColor: 'red',
+                            pointerEvents: 'none',
+                            zIndex: 999999
+                        });
+                        document.body.appendChild(dot);
+                    }
+                    dot.style.left = e.clientX + 'px';
+                    dot.style.top = e.clientY + 'px';
+                });
+            `
+        });
+    }
+}
+
+export default HumanMouse;

package/src/index.ts

@@ -1,13 +1,13 @@
-export * from "./actions";
-export * from "./core/config";
-export * from "./core/launcher";
-export * from "./core/pool";
-export * from "./human/mouse";
-export * from "./network/cache";
-export * from "./network/resource";
-export * from "./providers/local";
-export * from "./providers/adspower";
-export * from "./providers/ok";
-export * from "./providers/base";
-export * from "./types";
+export * from "./actions";
+export * from "./core/config";
+export * from "./core/launcher";
+export * from "./core/pool";
+export * from "./human/mouse";
+export * from "./network/cache";
+export * from "./network/resource";
+export * from "./providers/local";
+export * from "./providers/adspower";
+export * from "./providers/ok";
+export * from "./providers/base";
+export * from "./types";
 export * from "./const/browser";