weixin-devtools-mcp 0.0.1 → 0.1.1

package/build/core/assertion.js

@@ -0,0 +1,318 @@
+/**
+ * 断言验证核心逻辑
+ * 从 src/tools.ts 提取
+ */
+import { extractErrorMessage } from '../utils/error.js';
+/**
+ * 断言元素存在性
+ */
+export async function assertElementExists(page, options) {
+    const { selector, uid, timeout = 5000, shouldExist } = options;
+    if (!selector && !uid) {
+        throw new Error("必须提供selector或uid参数");
+    }
+    if (!page) {
+        throw new Error("页面对象是必需的");
+    }
+    const startTime = Date.now();
+    let element = null;
+    let actualExists = false;
+    try {
+        while (Date.now() - startTime < timeout) {
+            try {
+                if (selector) {
+                    element = await page.$(selector);
+                }
+                else if (uid) {
+                    element = await page.$(uid);
+                }
+                actualExists = !!element;
+                if (actualExists === shouldExist) {
+                    return {
+                        passed: true,
+                        message: `断言通过: 元素${shouldExist ? '存在' : '不存在'}`,
+                        actual: actualExists,
+                        expected: shouldExist,
+                        timestamp: Date.now()
+                    };
+                }
+                await new Promise(resolve => setTimeout(resolve, 100));
+            }
+            catch (error) {
+                // 继续检查直到超时
+            }
+        }
+        return {
+            passed: false,
+            message: `断言失败: 期望元素${shouldExist ? '存在' : '不存在'}，实际${actualExists ? '存在' : '不存在'}`,
+            actual: actualExists,
+            expected: shouldExist,
+            timestamp: Date.now()
+        };
+    }
+    catch (error) {
+        const errorMessage = extractErrorMessage(error);
+        return {
+            passed: false,
+            message: `断言执行失败: ${errorMessage}`,
+            actual: null,
+            expected: shouldExist,
+            timestamp: Date.now()
+        };
+    }
+}
+/**
+ * 断言元素可见性
+ */
+export async function assertElementVisible(page, elementMap, options) {
+    const { uid, visible } = options;
+    if (visible === undefined) {
+        throw new Error("必须指定visible参数");
+    }
+    if (!uid) {
+        throw new Error("元素uid是必需的");
+    }
+    if (!page) {
+        throw new Error("页面对象是必需的");
+    }
+    try {
+        const mapInfo = elementMap.get(uid);
+        if (!mapInfo) {
+            return {
+                passed: false,
+                message: `断言失败: 找不到uid为 ${uid} 的元素`,
+                actual: null,
+                expected: visible,
+                timestamp: Date.now()
+            };
+        }
+        const elements = await page.$$(mapInfo.selector);
+        if (!elements || elements.length === 0) {
+            return {
+                passed: false,
+                message: `断言失败: 无法找到选择器为 ${mapInfo.selector} 的元素`,
+                actual: false,
+                expected: visible,
+                timestamp: Date.now()
+            };
+        }
+        if (mapInfo.index >= elements.length) {
+            return {
+                passed: false,
+                message: `断言失败: 元素索引 ${mapInfo.index} 超出范围，共找到 ${elements.length} 个元素`,
+                actual: false,
+                expected: visible,
+                timestamp: Date.now()
+            };
+        }
+        const element = elements[mapInfo.index];
+        if (!element) {
+            return {
+                passed: false,
+                message: `断言失败: 无法获取索引为 ${mapInfo.index} 的元素`,
+                actual: false,
+                expected: visible,
+                timestamp: Date.now()
+            };
+        }
+        const size = await element.size();
+        const actualVisible = size.width > 0 && size.height > 0;
+        const passed = actualVisible === visible;
+        return {
+            passed,
+            message: passed
+                ? `断言通过: 元素${visible ? '可见' : '不可见'}`
+                : `断言失败: 期望元素${visible ? '可见' : '不可见'}，实际${actualVisible ? '可见' : '不可见'}`,
+            actual: actualVisible,
+            expected: visible,
+            timestamp: Date.now()
+        };
+    }
+    catch (error) {
+        const errorMessage = extractErrorMessage(error);
+        return {
+            passed: false,
+            message: `断言执行失败: ${errorMessage}`,
+            actual: null,
+            expected: visible,
+            timestamp: Date.now()
+        };
+    }
+}
+/**
+ * 断言元素文本内容
+ */
+export async function assertElementText(page, elementMap, options) {
+    const { uid, text, textContains, textMatches } = options;
+    if (!text && !textContains && !textMatches) {
+        throw new Error("必须指定text、textContains或textMatches参数之一");
+    }
+    if (!uid) {
+        throw new Error("元素uid是必需的");
+    }
+    if (!page) {
+        throw new Error("页面对象是必需的");
+    }
+    try {
+        const mapInfo = elementMap.get(uid);
+        if (!mapInfo) {
+            return {
+                passed: false,
+                message: `断言失败: 找不到uid为 ${uid} 的元素`,
+                actual: null,
+                expected: text || textContains || textMatches,
+                timestamp: Date.now()
+            };
+        }
+        const elements = await page.$$(mapInfo.selector);
+        if (!elements || elements.length === 0) {
+            return {
+                passed: false,
+                message: `断言失败: 无法找到选择器为 ${mapInfo.selector} 的元素`,
+                actual: null,
+                expected: text || textContains || textMatches,
+                timestamp: Date.now()
+            };
+        }
+        if (mapInfo.index >= elements.length) {
+            return {
+                passed: false,
+                message: `断言失败: 元素索引 ${mapInfo.index} 超出范围，共找到 ${elements.length} 个元素`,
+                actual: null,
+                expected: text || textContains || textMatches,
+                timestamp: Date.now()
+            };
+        }
+        const element = elements[mapInfo.index];
+        if (!element) {
+            return {
+                passed: false,
+                message: `断言失败: 无法获取索引为 ${mapInfo.index} 的元素`,
+                actual: null,
+                expected: text || textContains || textMatches,
+                timestamp: Date.now()
+            };
+        }
+        const actualText = await element.text();
+        let passed = false;
+        let expectedValue = '';
+        let message = '';
+        if (text) {
+            passed = actualText === text;
+            expectedValue = text;
+            message = passed
+                ? `断言通过: 文本精确匹配`
+                : `断言失败: 期望文本 "${text}"，实际 "${actualText}"`;
+        }
+        else if (textContains) {
+            passed = actualText.includes(textContains);
+            expectedValue = textContains;
+            message = passed
+                ? `断言通过: 文本包含 "${textContains}"`
+                : `断言失败: 期望包含 "${textContains}"，实际文本 "${actualText}"`;
+        }
+        else if (textMatches) {
+            const regex = new RegExp(textMatches);
+            passed = regex.test(actualText);
+            expectedValue = textMatches;
+            message = passed
+                ? `断言通过: 文本匹配正则 ${textMatches}`
+                : `断言失败: 期望匹配正则 ${textMatches}，实际文本 "${actualText}"`;
+        }
+        return {
+            passed,
+            message,
+            actual: actualText,
+            expected: expectedValue,
+            timestamp: Date.now()
+        };
+    }
+    catch (error) {
+        const errorMessage = extractErrorMessage(error);
+        return {
+            passed: false,
+            message: `断言执行失败: ${errorMessage}`,
+            actual: null,
+            expected: text || textContains || textMatches,
+            timestamp: Date.now()
+        };
+    }
+}
+/**
+ * 断言元素属性
+ */
+export async function assertElementAttribute(page, elementMap, options) {
+    const { uid, attribute } = options;
+    if (!attribute) {
+        throw new Error("必须指定attribute参数");
+    }
+    if (!uid) {
+        throw new Error("元素uid是必需的");
+    }
+    if (!page) {
+        throw new Error("页面对象是必需的");
+    }
+    try {
+        const mapInfo = elementMap.get(uid);
+        if (!mapInfo) {
+            return {
+                passed: false,
+                message: `断言失败: 找不到uid为 ${uid} 的元素`,
+                actual: null,
+                expected: attribute.value,
+                timestamp: Date.now()
+            };
+        }
+        const elements = await page.$$(mapInfo.selector);
+        if (!elements || elements.length === 0) {
+            return {
+                passed: false,
+                message: `断言失败: 无法找到选择器为 ${mapInfo.selector} 的元素`,
+                actual: null,
+                expected: attribute.value,
+                timestamp: Date.now()
+            };
+        }
+        if (mapInfo.index >= elements.length) {
+            return {
+                passed: false,
+                message: `断言失败: 元素索引 ${mapInfo.index} 超出范围，共找到 ${elements.length} 个元素`,
+                actual: null,
+                expected: attribute.value,
+                timestamp: Date.now()
+            };
+        }
+        const element = elements[mapInfo.index];
+        if (!element) {
+            return {
+                passed: false,
+                message: `断言失败: 无法获取索引为 ${mapInfo.index} 的元素`,
+                actual: null,
+                expected: attribute.value,
+                timestamp: Date.now()
+            };
+        }
+        const actualValue = await element.attribute(attribute.key);
+        const passed = actualValue === attribute.value;
+        return {
+            passed,
+            message: passed
+                ? `断言通过: 属性 ${attribute.key} 值为 "${attribute.value}"`
+                : `断言失败: 期望属性 ${attribute.key} 值为 "${attribute.value}"，实际 "${actualValue}"`,
+            actual: actualValue,
+            expected: attribute.value,
+            timestamp: Date.now()
+        };
+    }
+    catch (error) {
+        const errorMessage = extractErrorMessage(error);
+        return {
+            passed: false,
+            message: `断言执行失败: ${errorMessage}`,
+            actual: null,
+            expected: attribute.value,
+            timestamp: Date.now()
+        };
+    }
+}
+//# sourceMappingURL=assertion.js.map

package/build/core/assertion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion.js","sourceRoot":"","sources":["../../src/core/assertion.ts"],"names":[],"mappings":"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"}

package/build/core/connection.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 连接管理核心逻辑
+ * 从 src/tools.ts 提取的连接相关函数
+ */
+import { DevToolsError } from '../types/errors.js';
+import type { ConnectOptions, ConnectResult, DetailedConnectResult, EnhancedConnectOptions } from './types.js';
+/**
+ * @deprecated 使用 DevToolsError 替代
+ * 保留此类以保持向后兼容性
+ */
+export declare class DevToolsConnectionError extends DevToolsError {
+    phase: 'startup' | 'connection' | 'health_check';
+    originalError?: Error | undefined;
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, phase: 'startup' | 'connection' | 'health_check', originalError?: Error | undefined, details?: Record<string, unknown> | undefined);
+}
+/**
+ * 连接到微信开发者工具
+ */
+export declare function connectDevtools(options: ConnectOptions): Promise<ConnectResult>;
+/**
+ * 智能连接到微信开发者工具（优化版）
+ */
+export declare function connectDevtoolsEnhanced(options: EnhancedConnectOptions): Promise<DetailedConnectResult>;
+/**
+ * 等待WebSocket服务就绪
+ */
+export declare function waitForWebSocketReady(port: number, timeout: number, verbose?: boolean): Promise<void>;
+/**
+ * 检查开发者工具是否运行
+ */
+export declare function checkDevToolsRunning(port: number): Promise<boolean>;
+/**
+ * 自动检测当前IDE运行的端口
+ */
+export declare function detectIDEPort(verbose?: boolean): Promise<number | null>;
+//# sourceMappingURL=connection.d.ts.map

package/build/core/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/core/connection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,OAAO,EACL,aAAa,EAId,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EAGvB,MAAM,YAAY,CAAC;AAMpB;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;IAG/C,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,cAAc;IAChD,aAAa,CAAC,EAAE,KAAK;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAHxC,OAAO,EAAE,MAAM,EACR,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,cAAc,EAChD,aAAa,CAAC,EAAE,KAAK,YAAA,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAqB3C;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA+RrF;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA8ChC;AA2TD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgClH;AA8BD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASzE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,OAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0DpF"}