assistsx-js 0.0.1353 → 0.0.2001

package/dist/AssistsX.d.ts

@@ -2,12 +2,13 @@
  * AssistsX 类
  * 提供与移动应用程序界面交互的工具类，包括节点查找、手势操作、屏幕操作等功能
  */
-import { Node } from './Node';
-import { Bounds } from './Bounds';
+import { Node } from "./Node";
+import { CallResponse } from "./CallResponse";
+import { Bounds } from "./Bounds";
 /**
  * Web浮动窗口选项接口定义
  */
-interface WebFloatingWindowOptions {
+export interface WebFloatingWindowOptions {
     initialWidth?: number;
     initialHeight?: number;
     minWidth?: number;
@@ -16,6 +17,10 @@ interface WebFloatingWindowOptions {
     maxHeight?: number;
     initialCenter?: boolean;
 }
+export declare const callbacks: {
+    [key: string]: (data: any) => void;
+};
+export declare const accessibilityEventListeners: ((event: any) => void)[];
 export declare class AssistsX {
     /**
      * 执行同步调用
@@ -23,14 +28,21 @@ export declare class AssistsX {
      * @param args 参数对象
      * @returns 调用响应
      */
-    private static call;
+    static call(method: string, { args, node }?: {
+        args?: any;
+        node?: Node;
+    }): CallResponse;
     /**
      * 执行异步调用
      * @param method 方法名
      * @param args 参数对象
      * @returns Promise<调用响应>
      */
-    private static asyncCall;
+    static asyncCall(method: string, { args, node, nodes }?: {
+        args?: any;
+        node?: Node;
+        nodes?: Node[];
+    }): Promise<CallResponse>;
     /**
      * 设置悬浮窗标志
      * @param flags 标志
@@ -51,7 +63,7 @@ export declare class AssistsX {
      * @param filterText 文本过滤
      * @returns 节点数组
      */
-    static getAllNodes({ filterClass, filterViewId, filterDes, filterText }?: {
+    static getAllNodes({ filterClass, filterViewId, filterDes, filterText, }?: {
         filterClass?: string;
         filterViewId?: string;
         filterDes?: string;
@@ -112,7 +124,7 @@ export declare class AssistsX {
      * @param node 父节点范围
      * @returns 节点数组
      */
-    static findById(id: string, { filterClass, filterText, filterDes, node }?: {
+    static findById(id: string, { filterClass, filterText, filterDes, node, }?: {
         filterClass?: string;
         filterText?: string;
         filterDes?: string;
@@ -127,7 +139,7 @@ export declare class AssistsX {
      * @param node 父节点范围
      * @returns 节点数组
      */
-    static findByText(text: string, { filterClass, filterViewId, filterDes, node }?: {
+    static findByText(text: string, { filterClass, filterViewId, filterDes, node, }?: {
         filterClass?: string;
         filterViewId?: string;
         filterDes?: string;
@@ -142,7 +154,7 @@ export declare class AssistsX {
      * @param node 父节点范围
      * @returns 节点数组
      */
-    static findByTags(className: string, { filterText, filterViewId, filterDes, node }?: {
+    static findByTags(className: string, { filterText, filterViewId, filterDes, node, }?: {
         filterText?: string;
         filterViewId?: string;
         filterDes?: string;
@@ -202,7 +214,7 @@ export declare class AssistsX {
      * @param isFullyByCompareNode 是否完全可见
      * @returns 是否可见
      */
-    static isVisible(node: Node, { compareNode, isFullyByCompareNode }?: {
+    static isVisible(node: Node, { compareNode, isFullyByCompareNode, }?: {
         compareNode?: Node;
         isFullyByCompareNode?: boolean;
     }): boolean;
@@ -241,6 +253,7 @@ export declare class AssistsX {
      * @returns 是否成功
      */
     static paste(node: Node, text: string): boolean;
+    static focus(node: Node): boolean;
     /**
      * 选择文本
      * @param node 目标节点
@@ -270,7 +283,7 @@ export declare class AssistsX {
      * @param clickDuration 点击持续时间
      * @returns 是否成功
      */
-    static clickNodeByGesture(node: Node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration }?: {
+    static clickNodeByGesture(node: Node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, }?: {
         offsetX?: number;
         offsetY?: number;
         switchWindowIntervalDelay?: number;
@@ -286,7 +299,7 @@ export declare class AssistsX {
      * @param clickInterval 点击间隔
      * @returns 是否成功
      */
-    static doubleClickNodeByGesture(node: Node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval }?: {
+    static doubleClickNodeByGesture(node: Node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, }?: {
         offsetX?: number;
         offsetY?: number;
         switchWindowIntervalDelay?: number;
@@ -309,7 +322,7 @@ export declare class AssistsX {
     }, { duration }?: {
         duration?: number;
     }): Promise<boolean>;
-    static longPressNodeByGestureAutoPaste(node: Node, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration }?: {
+    static longPressNodeByGestureAutoPaste(node: Node, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, }?: {
         matchedPackageName?: string;
         matchedText?: string;
         timeoutMillis?: number;
@@ -318,7 +331,7 @@ export declare class AssistsX {
     static longPressGestureAutoPaste(point: {
         x: number;
         y: number;
-    }, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration }?: {
+    }, text: string, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, }?: {
         matchedPackageName?: string;
         matchedText?: string;
         timeoutMillis?: number;
@@ -360,4 +373,3 @@ export declare class AssistsX {
      */
     static getAccessibilityEventListenerCount(): number;
 }
-export {};

package/dist/AssistsX.js

@@ -2,17 +2,17 @@
  * AssistsX 类
  * 提供与移动应用程序界面交互的工具类，包括节点查找、手势操作、屏幕操作等功能
  */
-import { Node } from './Node';
-import { CallMethod } from './CallMethod';
-import { CallResponse } from './CallResponse';
-import { Bounds } from './Bounds';
-import { generateUUID } from './Utils';
+import { Node } from "./Node";
+import { CallMethod } from "./CallMethod";
+import { CallResponse } from "./CallResponse";
+import { Bounds } from "./Bounds";
+import { generateUUID } from "./Utils";
 // 回调函数存储对象
-const callbacks = {};
+export const callbacks = {};
 // 无障碍事件监听器存储
-const accessibilityEventListeners = [];
+export const accessibilityEventListeners = [];
 // 初始化全局回调函数
-if (typeof window !== 'undefined' && !window.assistsxCallback) {
+if (typeof window !== "undefined" && !window.assistsxCallback) {
     window.assistsxCallback = (data) => {
         const response = JSON.parse(data);
         const callback = callbacks[response.callbackId];
@@ -22,15 +22,15 @@ if (typeof window !== 'undefined' && !window.assistsxCallback) {
     };
 }
 // 初始化全局无障碍事件函数
-if (typeof window !== 'undefined' && !window.onAccessibilityEvent) {
+if (typeof window !== "undefined" && !window.onAccessibilityEvent) {
     window.onAccessibilityEvent = (event) => {
         // 通知所有注册的监听器
-        accessibilityEventListeners.forEach(listener => {
+        accessibilityEventListeners.forEach((listener) => {
             try {
                 listener(event);
             }
             catch (error) {
-                console.error('Accessibility event listener error:', error);
+                console.error("Accessibility event listener error:", error);
             }
         });
     };
@@ -49,12 +49,12 @@ export class AssistsX {
             node: node ? node : undefined,
         };
         const result = window.assistsx.call(JSON.stringify(params));
-        if (typeof result === 'string') {
+        if (typeof result === "string") {
             const responseData = JSON.parse(result);
             const response = new CallResponse(responseData.code, responseData.data, responseData.callbackId);
             return response;
         }
-        throw new Error('Call failed');
+        throw new Error("Call failed");
     }
     /**
      * 执行异步调用
@@ -81,12 +81,12 @@ export class AssistsX {
         });
         const result = window.assistsx.call(JSON.stringify(params));
         const promiseResult = await promise;
-        if (typeof promiseResult === 'string') {
+        if (typeof promiseResult === "string") {
             const responseData = JSON.parse(promiseResult);
             const response = new CallResponse(responseData.code, responseData.data, responseData.callbackId);
             return response;
         }
-        throw new Error('Call failed');
+        throw new Error("Call failed");
     }
     /**
      * 设置悬浮窗标志
@@ -94,7 +94,9 @@ export class AssistsX {
      * @returns 是否设置成功
      */
     static setOverlayFlags(flags) {
-        const response = this.call(CallMethod.setOverlayFlags, { args: { flags: flags } });
+        const response = this.call(CallMethod.setOverlayFlags, {
+            args: { flags: flags },
+        });
         return response.getDataOrDefault(false);
     }
     /**
@@ -103,7 +105,9 @@ export class AssistsX {
      * @returns 是否设置成功
      */
     static setOverlayFlagList(flags) {
-        const response = this.call(CallMethod.setOverlayFlags, { args: { flags: flags } });
+        const response = this.call(CallMethod.setOverlayFlags, {
+            args: { flags: flags },
+        });
         return response.getDataOrDefault(false);
     }
     /**
@@ -114,8 +118,10 @@ export class AssistsX {
      * @param filterText 文本过滤
      * @returns 节点数组
      */
-    static getAllNodes({ filterClass, filterViewId, filterDes, filterText } = {}) {
-        const response = this.call(CallMethod.getAllNodes, { args: { filterClass, filterViewId, filterDes, filterText } });
+    static getAllNodes({ filterClass, filterViewId, filterDes, filterText, } = {}) {
+        const response = this.call(CallMethod.getAllNodes, {
+            args: { filterClass, filterViewId, filterDes, filterText },
+        });
         return Node.fromJSONArray(response.getDataOrDefault("[]"));
     }
     /**
@@ -125,7 +131,10 @@ export class AssistsX {
      * @returns 是否设置成功
      */
     static setNodeText(node, text) {
-        const response = this.call(CallMethod.setNodeText, { args: { text }, node });
+        const response = this.call(CallMethod.setNodeText, {
+            args: { text },
+            node,
+        });
         return response.getDataOrDefault(false);
     }
     /**
@@ -135,7 +144,10 @@ export class AssistsX {
      * @returns 截图路径数组
      */
     static async takeScreenshotNodes(nodes, overlayHiddenScreenshotDelayMillis = 250) {
-        const response = await this.asyncCall(CallMethod.takeScreenshot, { nodes, args: { overlayHiddenScreenshotDelayMillis } });
+        const response = await this.asyncCall(CallMethod.takeScreenshot, {
+            nodes,
+            args: { overlayHiddenScreenshotDelayMillis },
+        });
         const data = response.getDataOrDefault("");
         return data.images;
     }
@@ -145,8 +157,19 @@ export class AssistsX {
         return data.value;
     }
     static async loadWebViewOverlay(url, options = {}) {
-        const { initialWidth, initialHeight, minWidth, minHeight, maxWidth, maxHeight, initialCenter } = options;
-        const response = await this.asyncCall(CallMethod.loadWebViewOverlay, { args: { url, initialWidth, initialHeight, minWidth, minHeight, maxWidth, maxHeight, initialCenter } });
+        const { initialWidth, initialHeight, minWidth, minHeight, maxWidth, maxHeight, initialCenter, } = options;
+        const response = await this.asyncCall(CallMethod.loadWebViewOverlay, {
+            args: {
+                url,
+                initialWidth,
+                initialHeight,
+                minWidth,
+                minHeight,
+                maxWidth,
+                maxHeight,
+                initialCenter,
+            },
+        });
         const data = response.getDataOrDefault({});
         return data;
     }
@@ -192,7 +215,9 @@ export class AssistsX {
      * @returns 是否显示成功
      */
     static overlayToast(text, delay = 2000) {
-        const response = this.call(CallMethod.overlayToast, { args: { text, delay } });
+        const response = this.call(CallMethod.overlayToast, {
+            args: { text, delay },
+        });
         return response.getDataOrDefault(false);
     }
     /**
@@ -204,8 +229,11 @@ export class AssistsX {
      * @param node 父节点范围
      * @returns 节点数组
      */
-    static findById(id, { filterClass, filterText, filterDes, node } = {}) {
-        const response = this.call(CallMethod.findById, { args: { id, filterClass, filterText, filterDes }, node });
+    static findById(id, { filterClass, filterText, filterDes, node, } = {}) {
+        const response = this.call(CallMethod.findById, {
+            args: { id, filterClass, filterText, filterDes },
+            node,
+        });
         return Node.fromJSONArray(response.getDataOrDefault("[]"));
     }
     /**
@@ -217,8 +245,11 @@ export class AssistsX {
      * @param node 父节点范围
      * @returns 节点数组
      */
-    static findByText(text, { filterClass, filterViewId, filterDes, node } = {}) {
-        const response = this.call(CallMethod.findByText, { args: { text, filterClass, filterViewId, filterDes }, node });
+    static findByText(text, { filterClass, filterViewId, filterDes, node, } = {}) {
+        const response = this.call(CallMethod.findByText, {
+            args: { text, filterClass, filterViewId, filterDes },
+            node,
+        });
         return Node.fromJSONArray(response.getDataOrDefault("[]"));
     }
     /**
@@ -230,8 +261,11 @@ export class AssistsX {
      * @param node 父节点范围
      * @returns 节点数组
      */
-    static findByTags(className, { filterText, filterViewId, filterDes, node } = {}) {
-        const response = this.call(CallMethod.findByTags, { args: { className, filterText, filterViewId, filterDes }, node });
+    static findByTags(className, { filterText, filterViewId, filterDes, node, } = {}) {
+        const response = this.call(CallMethod.findByTags, {
+            args: { className, filterText, filterViewId, filterDes },
+            node,
+        });
         return Node.fromJSONArray(response.getDataOrDefault("[]"));
     }
     /**
@@ -240,7 +274,9 @@ export class AssistsX {
      * @returns 节点数组
      */
     static findByTextAllMatch(text) {
-        const response = this.call(CallMethod.findByTextAllMatch, { args: { text } });
+        const response = this.call(CallMethod.findByTextAllMatch, {
+            args: { text },
+        });
         return Node.fromJSONArray(response.getDataOrDefault("[]"));
     }
     /**
@@ -266,7 +302,9 @@ export class AssistsX {
      * @returns 父节点
      */
     static findFirstParentByTags(className) {
-        const response = this.call(CallMethod.findFirstParentByTags, { args: { className } });
+        const response = this.call(CallMethod.findFirstParentByTags, {
+            args: { className },
+        });
         return Node.create(response.getDataOrDefault("{}"));
     }
     /**
@@ -312,8 +350,11 @@ export class AssistsX {
      * @param isFullyByCompareNode 是否完全可见
      * @returns 是否可见
      */
-    static isVisible(node, { compareNode, isFullyByCompareNode } = {}) {
-        const response = this.call(CallMethod.isVisible, { node, args: { compareNode, isFullyByCompareNode } });
+    static isVisible(node, { compareNode, isFullyByCompareNode, } = {}) {
+        const response = this.call(CallMethod.isVisible, {
+            node,
+            args: { compareNode, isFullyByCompareNode },
+        });
         return response.getDataOrDefault(false);
     }
     /**
@@ -324,7 +365,9 @@ export class AssistsX {
      * @returns 是否成功
      */
     static async clickByGesture(x, y, duration) {
-        const response = await this.asyncCall(CallMethod.clickByGesture, { args: { x, y, duration } });
+        const response = await this.asyncCall(CallMethod.clickByGesture, {
+            args: { x, y, duration },
+        });
         return response.getDataOrDefault(false);
     }
     /**
@@ -369,6 +412,10 @@ export class AssistsX {
         const response = this.call(CallMethod.paste, { args: { text }, node });
         return response.getDataOrDefault(false);
     }
+    static focus(node) {
+        const response = this.call(CallMethod.focus, { node });
+        return response.getDataOrDefault(false);
+    }
     /**
      * 选择文本
      * @param node 目标节点
@@ -377,7 +424,10 @@ export class AssistsX {
      * @returns 是否成功
      */
     static selectionText(node, selectionStart, selectionEnd) {
-        const response = this.call(CallMethod.selectionText, { args: { selectionStart, selectionEnd }, node });
+        const response = this.call(CallMethod.selectionText, {
+            args: { selectionStart, selectionEnd },
+            node,
+        });
         return response.getDataOrDefault(false);
     }
     /**
@@ -407,8 +457,11 @@ export class AssistsX {
      * @param clickDuration 点击持续时间
      * @returns 是否成功
      */
-    static async clickNodeByGesture(node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration } = {}) {
-        const response = await this.asyncCall(CallMethod.clickNodeByGesture, { node, args: { offsetX, offsetY, switchWindowIntervalDelay, clickDuration } });
+    static async clickNodeByGesture(node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, } = {}) {
+        const response = await this.asyncCall(CallMethod.clickNodeByGesture, {
+            node,
+            args: { offsetX, offsetY, switchWindowIntervalDelay, clickDuration },
+        });
         return response.getDataOrDefault(false);
     }
     /**
@@ -421,8 +474,17 @@ export class AssistsX {
      * @param clickInterval 点击间隔
      * @returns 是否成功
      */
-    static async doubleClickNodeByGesture(node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval } = {}) {
-        const response = await this.asyncCall(CallMethod.doubleClickNodeByGesture, { node, args: { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval } });
+    static async doubleClickNodeByGesture(node, { offsetX, offsetY, switchWindowIntervalDelay, clickDuration, clickInterval, } = {}) {
+        const response = await this.asyncCall(CallMethod.doubleClickNodeByGesture, {
+            node,
+            args: {
+                offsetX,
+                offsetY,
+                switchWindowIntervalDelay,
+                clickDuration,
+                clickInterval,
+            },
+        });
         return response.getDataOrDefault(false);
     }
     /**
@@ -433,19 +495,41 @@ export class AssistsX {
      * @returns
      */
     static async performLinearGesture(startPoint, endPoint, { duration } = {}) {
-        const response = await this.asyncCall(CallMethod.performLinearGesture, { args: { startPoint, endPoint, duration } });
+        const response = await this.asyncCall(CallMethod.performLinearGesture, {
+            args: { startPoint, endPoint, duration },
+        });
         return response.getDataOrDefault(false);
     }
-    static async longPressNodeByGestureAutoPaste(node, text, { matchedPackageName, matchedText, timeoutMillis, longPressDuration } = { matchedText: "粘贴", timeoutMillis: 1500, longPressDuration: 600 }) {
-        const response = await this.asyncCall(CallMethod.longPressGestureAutoPaste, { node, args: { text, matchedPackageName, matchedText, timeoutMillis, longPressDuration } });
+    static async longPressNodeByGestureAutoPaste(node, text, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, } = { matchedText: "粘贴", timeoutMillis: 1500, longPressDuration: 600 }) {
+        const response = await this.asyncCall(CallMethod.longPressGestureAutoPaste, {
+            node,
+            args: {
+                text,
+                matchedPackageName,
+                matchedText,
+                timeoutMillis,
+                longPressDuration,
+            },
+        });
         return response.getDataOrDefault(false);
     }
-    static async longPressGestureAutoPaste(point, text, { matchedPackageName, matchedText, timeoutMillis, longPressDuration } = { matchedText: "粘贴", timeoutMillis: 1500, longPressDuration: 600 }) {
-        const response = await this.asyncCall(CallMethod.longPressGestureAutoPaste, { args: { point, text, matchedPackageName, matchedText, timeoutMillis, longPressDuration } });
+    static async longPressGestureAutoPaste(point, text, { matchedPackageName, matchedText, timeoutMillis, longPressDuration, } = { matchedText: "粘贴", timeoutMillis: 1500, longPressDuration: 600 }) {
+        const response = await this.asyncCall(CallMethod.longPressGestureAutoPaste, {
+            args: {
+                point,
+                text,
+                matchedPackageName,
+                matchedText,
+                timeoutMillis,
+                longPressDuration,
+            },
+        });
         return response.getDataOrDefault(false);
     }
     static async getAppInfo(packageName) {
-        const response = await this.asyncCall(CallMethod.getAppInfo, { args: { packageName } });
+        const response = await this.asyncCall(CallMethod.getAppInfo, {
+            args: { packageName },
+        });
         return response.getDataOrDefault({});
     }
     static getUniqueDeviceId() {
@@ -488,7 +572,7 @@ export class AssistsX {
                 listener(event);
             }
             catch (error) {
-                console.error('Accessibility event listener error:', error);
+                console.error("Accessibility event listener error:", error);
             }
         };
         // 将监听器包装并存储，使用ID作为键