@pyrokine/mcp-chrome 1.0.0

package/dist/core/locator.js

@@ -0,0 +1,402 @@
+/**
+ * 元素定位器
+ *
+ * 统一的元素定位逻辑，支持多种定位方式：
+ * - 可访问性树（role/name）
+ * - 文本内容
+ * - CSS 选择器
+ * - XPath
+ * - 坐标
+ *
+ * 设计原则：
+ * - 封装：隐藏定位细节，暴露简洁接口
+ * - 以对象取代基本类型：Target 对象而非字符串
+ */
+import { ElementNotFoundError } from './errors.js';
+import { withRetry } from './retry.js';
+import { isAltTarget, isCoordinateTarget, isCSSTarget, isLabelTarget, isPlaceholderTarget, isRoleTarget, isTestIdTarget, isTextTarget, isTitleTarget, isXPathTarget, } from './types.js';
+const DEFAULT_TIMEOUT = 30000;
+/**
+ * 转义 XPath 字符串中的引号
+ * XPath 1.0 没有转义机制，需要用 concat() 拼接单双引号
+ *
+ * 例如: "It's a \"test\"" => concat('It', "'", 's a "test"')
+ */
+function escapeXPathString(str) {
+    if (!str.includes('\'')) {
+        return `'${str}'`;
+    }
+    if (!str.includes('"')) {
+        return `"${str}"`;
+    }
+    // 同时包含单双引号，使用 concat() 拼接
+    // 策略：遇到单引号用双引号包裹，其他部分用单引号包裹
+    const parts = [];
+    let current = '';
+    for (const char of str) {
+        if (char === '\'') {
+            if (current) {
+                parts.push(`'${current}'`);
+                current = '';
+            }
+            parts.push(`"'"`);
+        }
+        else {
+            current += char;
+        }
+    }
+    if (current) {
+        parts.push(`'${current}'`);
+    }
+    return `concat(${parts.join(', ')})`;
+}
+/**
+ * 转义 JavaScript 字符串
+ */
+function escapeJSString(str) {
+    return str
+        .replace(/\\/g, '\\\\')
+        .replace(/'/g, '\\\'')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t');
+}
+/**
+ * 转义 CSS 属性选择器值
+ * CSS.escape() 的 polyfill
+ */
+function escapeCSSAttributeValue(str) {
+    return str.replace(/["\\]/g, '\\$&');
+}
+/**
+ * 元素定位器
+ */
+export class Locator {
+    cdp;
+    target;
+    sessionId;
+    logs = [];
+    timeout;
+    getUrl;
+    constructor(cdp, target, sessionId, options = {}) {
+        this.cdp = cdp;
+        this.target = target;
+        this.sessionId = sessionId;
+        this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+        this.getUrl = options.getUrl;
+    }
+    /**
+     * 查找元素，返回节点 ID（带重试）
+     */
+    async find() {
+        this.logs = [];
+        this.log(`定位元素: ${JSON.stringify(this.target)}`);
+        if (isCoordinateTarget(this.target)) {
+            // 坐标定位不需要 NodeId
+            throw new Error('坐标定位不支持 find()，请使用 getClickablePoint()');
+        }
+        return withRetry(() => this.findInternal(), { timeout: this.timeout });
+    }
+    /**
+     * 获取元素中心坐标（用于点击）
+     */
+    async getClickablePoint() {
+        if (isCoordinateTarget(this.target)) {
+            return { x: this.target.x, y: this.target.y };
+        }
+        const nodeId = await this.find();
+        const box = await this.getBoxModel(nodeId);
+        return {
+            x: box.x + box.width / 2,
+            y: box.y + box.height / 2,
+        };
+    }
+    /**
+     * 获取元素边界框
+     */
+    async getBoundingBox() {
+        if (isCoordinateTarget(this.target)) {
+            return { x: this.target.x, y: this.target.y, width: 0, height: 0 };
+        }
+        const nodeId = await this.find();
+        return this.getBoxModel(nodeId);
+    }
+    /**
+     * 在找到的元素上执行函数
+     *
+     * @param fn 要执行的函数字符串，元素作为第一个参数
+     * @returns 函数返回值
+     */
+    async evaluateOn(fn) {
+        const nodeId = await this.find();
+        // 将 nodeId 转换为 RemoteObjectId
+        const { object } = (await this.send('DOM.resolveNode', {
+            nodeId,
+        }));
+        if (!object?.objectId) {
+            throw new ElementNotFoundError(this.target, this.timeout, this.logs, this.getUrl?.());
+        }
+        // 在元素上执行函数
+        const { result, exceptionDetails } = (await this.send('Runtime.callFunctionOn', {
+            objectId: object.objectId,
+            functionDeclaration: fn,
+            returnByValue: true,
+        }));
+        if (exceptionDetails) {
+            throw new Error(`执行失败: ${exceptionDetails.text}`);
+        }
+        return result.value;
+    }
+    /**
+     * 获取定位日志
+     */
+    getLogs() {
+        return this.logs;
+    }
+    /**
+     * 查找元素的内部实现（单次尝试）
+     */
+    async findInternal() {
+        if (isRoleTarget(this.target)) {
+            return this.findByAccessibility();
+        }
+        if (isTextTarget(this.target)) {
+            return this.findByText();
+        }
+        if (isLabelTarget(this.target)) {
+            return this.findByLabel();
+        }
+        if (isPlaceholderTarget(this.target)) {
+            return this.findByPlaceholder();
+        }
+        if (isTitleTarget(this.target)) {
+            return this.findByTitle();
+        }
+        if (isAltTarget(this.target)) {
+            return this.findByAlt();
+        }
+        if (isTestIdTarget(this.target)) {
+            return this.findByTestId();
+        }
+        if (isCSSTarget(this.target)) {
+            return this.findByCSS();
+        }
+        if (isXPathTarget(this.target)) {
+            return this.findByXPath();
+        }
+        throw new Error(`不支持的 target 类型: ${JSON.stringify(this.target)}`);
+    }
+    /**
+     * 通过可访问性树定位
+     */
+    async findByAccessibility() {
+        const { role, name } = this.target;
+        this.log(`使用可访问性树定位: role=${role}, name=${name ?? '(any)'}`);
+        // 启用可访问性
+        await this.send('Accessibility.enable');
+        // 获取整个可访问性树
+        const { nodes } = (await this.send('Accessibility.getFullAXTree'));
+        // 查找匹配的节点
+        for (const node of nodes) {
+            if (node.role?.value?.toLowerCase() !== role.toLowerCase()) {
+                continue;
+            }
+            if (name !== undefined && node.name?.value !== name) {
+                continue;
+            }
+            if (node.backendDOMNodeId) {
+                this.log(`找到元素: backendDOMNodeId=${node.backendDOMNodeId}`);
+                // 将 backendDOMNodeId 转换为 nodeId
+                const { nodeIds } = (await this.send('DOM.pushNodesByBackendIdsToFrontend', {
+                    backendNodeIds: [node.backendDOMNodeId],
+                }));
+                if (nodeIds.length > 0 && nodeIds[0] !== 0) {
+                    return nodeIds[0];
+                }
+            }
+        }
+        throw new ElementNotFoundError(this.target, this.timeout, this.logs, this.getUrl?.());
+    }
+    /**
+     * 通过文本内容定位
+     */
+    async findByText() {
+        const { text, exact = false } = this.target;
+        this.log(`使用文本内容定位: text=${text}, exact=${exact}`);
+        // 使用 XPath 查找包含文本的元素（正确转义引号）
+        const escapedText = escapeXPathString(text);
+        const xpath = exact
+            ? `//*[text()=${escapedText}]`
+            : `//*[contains(text(),${escapedText})]`;
+        return this.findByXPathInternal(xpath);
+    }
+    /**
+     * 通过 label 定位
+     */
+    async findByLabel() {
+        const { label, exact = false } = this.target;
+        this.log(`使用 label 定位: label=${label}, exact=${exact}`);
+        // 转义 JS 字符串
+        const escapedLabel = escapeJSString(label);
+        // 使用 Runtime.evaluate 执行复杂查询
+        const { result } = (await this.send('Runtime.evaluate', {
+            expression: `
+        (function() {
+          const targetLabel = "${escapedLabel}";
+          const isExact = ${exact};
+          const labels = document.querySelectorAll('label');
+          for (const label of labels) {
+            const text = label.textContent?.trim() ?? '';
+            const match = isExact ? text === targetLabel : text.includes(targetLabel);
+            if (match) {
+              // 通过 for 属性找关联元素
+              if (label.htmlFor) {
+                const input = document.getElementById(label.htmlFor);
+                if (input) return input;
+              }
+              // 找 label 内部的 input
+              const input = label.querySelector('input, select, textarea');
+              if (input) return input;
+            }
+          }
+          return null;
+        })()
+      `,
+            returnByValue: false,
+        }));
+        if (!result.objectId) {
+            throw new ElementNotFoundError(this.target, this.timeout, this.logs, this.getUrl?.());
+        }
+        return this.objectIdToNodeId(result.objectId);
+    }
+    /**
+     * 通过 placeholder 定位
+     */
+    async findByPlaceholder() {
+        const { placeholder, exact = false } = this.target;
+        this.log(`使用 placeholder 定位: placeholder=${placeholder}, exact=${exact}`);
+        const escaped = escapeCSSAttributeValue(placeholder);
+        const css = exact
+            ? `[placeholder="${escaped}"]`
+            : `[placeholder*="${escaped}"]`;
+        return this.findByCSSInternal(css);
+    }
+    /**
+     * 通过 title 属性定位
+     */
+    async findByTitle() {
+        const { title, exact = false } = this.target;
+        this.log(`使用 title 属性定位: title=${title}, exact=${exact}`);
+        const escaped = escapeCSSAttributeValue(title);
+        const css = exact ? `[title="${escaped}"]` : `[title*="${escaped}"]`;
+        return this.findByCSSInternal(css);
+    }
+    /**
+     * 通过 alt 属性定位
+     */
+    async findByAlt() {
+        const { alt, exact = false } = this.target;
+        this.log(`使用 alt 属性定位: alt=${alt}, exact=${exact}`);
+        const escaped = escapeCSSAttributeValue(alt);
+        const css = exact ? `[alt="${escaped}"]` : `[alt*="${escaped}"]`;
+        return this.findByCSSInternal(css);
+    }
+    /**
+     * 通过 data-testid 定位
+     */
+    async findByTestId() {
+        const { testId } = this.target;
+        this.log(`使用 data-testid 定位: testId=${testId}`);
+        const escaped = escapeCSSAttributeValue(testId);
+        return this.findByCSSInternal(`[data-testid="${escaped}"]`);
+    }
+    /**
+     * 通过 CSS 选择器定位
+     */
+    async findByCSS() {
+        const { css } = this.target;
+        this.log(`使用 CSS 选择器定位: css=${css}`);
+        return this.findByCSSInternal(css);
+    }
+    /**
+     * 通过 XPath 定位
+     */
+    async findByXPath() {
+        const { xpath } = this.target;
+        this.log(`使用 XPath 定位: xpath=${xpath}`);
+        return this.findByXPathInternal(xpath);
+    }
+    /**
+     * CSS 选择器定位内部实现
+     */
+    async findByCSSInternal(css) {
+        // 确保 DOM 已启用
+        const { root } = (await this.send('DOM.getDocument'));
+        const { nodeId } = (await this.send('DOM.querySelector', {
+            nodeId: root.nodeId,
+            selector: css,
+        }));
+        if (nodeId === 0) {
+            this.log(`元素未找到: ${css}`);
+            throw new ElementNotFoundError(this.target, this.timeout, this.logs, this.getUrl?.());
+        }
+        this.log(`找到元素: nodeId=${nodeId}`);
+        return nodeId;
+    }
+    /**
+     * XPath 定位内部实现
+     */
+    async findByXPathInternal(xpath) {
+        // 使用 Runtime.evaluate 执行 XPath
+        const { result } = (await this.send('Runtime.evaluate', {
+            expression: `document.evaluate('${xpath.replace(/'/g, '\\\'')}', document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue`,
+            returnByValue: false,
+        }));
+        if (!result.objectId) {
+            this.log(`元素未找到: ${xpath}`);
+            throw new ElementNotFoundError(this.target, this.timeout, this.logs, this.getUrl?.());
+        }
+        return this.objectIdToNodeId(result.objectId);
+    }
+    /**
+     * 将 RemoteObject ID 转换为 NodeId
+     */
+    async objectIdToNodeId(objectId) {
+        const { nodeId } = (await this.send('DOM.requestNode', {
+            objectId,
+        }));
+        if (nodeId === 0) {
+            throw new ElementNotFoundError(this.target, this.timeout, this.logs, this.getUrl?.());
+        }
+        this.log(`找到元素: nodeId=${nodeId}`);
+        return nodeId;
+    }
+    /**
+     * 获取元素边界框
+     */
+    async getBoxModel(nodeId) {
+        const { model } = (await this.send('DOM.getBoxModel', { nodeId }));
+        // content 是 [x1,y1, x2,y2, x3,y3, x4,y4] 格式的四个角坐标
+        const [x1, y1, x2, , , , x4, y4] = model.content;
+        return {
+            x: x1,
+            y: y1,
+            width: x2 - x1,
+            height: y4 - y1,
+        };
+    }
+    /**
+     * 发送 CDP 命令
+     */
+    send(method, params) {
+        return this.cdp.send(method, params, this.sessionId);
+    }
+    /**
+     * 记录日志
+     */
+    log(message) {
+        this.logs.push(message);
+    }
+}
+//# sourceMappingURL=locator.js.map

package/dist/core/locator.js.map

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

package/dist/core/retry.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 重试策略
+ *
+ * 参考 Puppeteer Locator 的重试机制
+ * RETRY_DELAY = 100ms
+ */
+/**
+ * 重试选项
+ */
+export interface RetryOptions {
+    /** 超时时间（毫秒） */
+    timeout?: number;
+    /** 重试间隔（毫秒） */
+    retryDelay?: number;
+}
+/**
+ * 带重试的函数执行
+ *
+ * 在超时时间内不断重试，直到成功或超时。
+ * 超时后抛出最后一次的错误。
+ *
+ * @param fn 要执行的函数
+ * @param options 重试选项
+ * @returns 函数返回值
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/core/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/core/retry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAKD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GAC3B,OAAO,CAAC,CAAC,CAAC,CA2BZ"}

package/dist/core/retry.js

@@ -0,0 +1,51 @@
+/**
+ * 重试策略
+ *
+ * 参考 Puppeteer Locator 的重试机制
+ * RETRY_DELAY = 100ms
+ */
+import { TimeoutError } from './errors.js';
+const DEFAULT_TIMEOUT = 30000;
+const DEFAULT_RETRY_DELAY = 100;
+/**
+ * 带重试的函数执行
+ *
+ * 在超时时间内不断重试，直到成功或超时。
+ * 超时后抛出最后一次的错误。
+ *
+ * @param fn 要执行的函数
+ * @param options 重试选项
+ * @returns 函数返回值
+ */
+export async function withRetry(fn, options = {}) {
+    const { timeout = DEFAULT_TIMEOUT, retryDelay = DEFAULT_RETRY_DELAY } = options;
+    const deadline = Date.now() + timeout;
+    let lastError = null;
+    let attempts = 0;
+    while (Date.now() < deadline) {
+        attempts++;
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // 如果剩余时间不足以进行下一次重试，直接抛出错误
+            if (Date.now() + retryDelay >= deadline) {
+                break;
+            }
+            await delay(retryDelay);
+        }
+    }
+    // 超时，抛出最后的错误或超时错误
+    if (lastError) {
+        throw lastError;
+    }
+    throw new TimeoutError(`操作超时 (${timeout}ms, ${attempts} 次尝试)`);
+}
+/**
+ * 延迟
+ */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/core/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/core/retry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAA;AAYxC,MAAM,eAAe,GAAO,KAAK,CAAA;AACjC,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAE/B;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC3B,EAAoB,EACpB,UAAwB,EAAE;IAE1B,MAAM,EAAC,OAAO,GAAG,eAAe,EAAE,UAAU,GAAG,mBAAmB,EAAC,GAAG,OAAO,CAAA;IAC7E,MAAM,QAAQ,GAAwD,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAA;IAC1F,IAAI,SAAS,GAAyD,IAAI,CAAA;IAC1E,IAAI,QAAQ,GAA0D,CAAC,CAAA;IAEvE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC3B,QAAQ,EAAE,CAAA;QACV,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAA;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,SAAS,GAAG,KAAc,CAAA;YAE1B,0BAA0B;YAC1B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;gBACtC,MAAK;YACT,CAAC;YAED,MAAM,KAAK,CAAC,UAAU,CAAC,CAAA;QAC3B,CAAC;IACL,CAAC;IAED,kBAAkB;IAClB,IAAI,SAAS,EAAE,CAAC;QACZ,MAAM,SAAS,CAAA;IACnB,CAAC;IACD,MAAM,IAAI,YAAY,CAAC,SAAS,OAAO,OAAO,QAAQ,OAAO,CAAC,CAAA;AAClE,CAAC;AAED;;GAEG;AACH,SAAS,KAAK,CAAC,EAAU;IACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAC5D,CAAC"}