assistsx-js 0.0.3008 → 0.1.1

package/dist/AssistsXAsync.d.ts

@@ -103,6 +103,21 @@ export declare class AssistsXAsync {
      * @returns 截图路径数组
      */
     static takeScreenshotNodes(nodes: Node[], overlayHiddenScreenshotDelayMillis?: number, timeout?: number): Promise<string[]>;
+    /**
+     * 保存全屏截图到文件
+     * @param options 截图保存选项
+     * @param options.filePath 文件路径（可选，不提供则自动生成）
+     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
+     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @returns 保存的文件路径
+     */
+    static takeScreenshotSave(options?: {
+        filePath?: string;
+        format?: "PNG" | "JPEG" | "JPG" | "WEBP";
+        overlayHiddenScreenshotDelayMillis?: number;
+        timeout?: number;
+    }): Promise<string>;
     /**
      * 截图识别文本
      * @param param0 识别参数

package/dist/AssistsXAsync.js

@@ -124,6 +124,28 @@ export class AssistsXAsync {
         const data = response.getDataOrDefault({ images: [] });
         return data.images;
     }
+    /**
+     * 保存全屏截图到文件
+     * @param options 截图保存选项
+     * @param options.filePath 文件路径（可选，不提供则自动生成）
+     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
+     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @returns 保存的文件路径
+     */
+    static async takeScreenshotSave(options = {}) {
+        const { filePath, format = "PNG", overlayHiddenScreenshotDelayMillis = 250, timeout, } = options;
+        const response = await this.asyncCall(CallMethod.takeScreenshotSave, {
+            args: {
+                filePath,
+                format,
+                overlayHiddenScreenshotDelayMillis,
+            },
+            timeout,
+        });
+        const data = response.getDataOrDefault({ file: "" });
+        return data.file;
+    }
     /**
      * 截图识别文本
      * @param param0 识别参数

package/dist/CallMethod.d.ts

@@ -1,5 +1,6 @@
 export declare const CallMethod: {
     readonly takeScreenshot: "takeScreenshot";
+    readonly takeScreenshotSave: "takeScreenshotSave";
     readonly overlayToast: "overlayToast";
     readonly setNodeText: "setNodeText";
     readonly findByTags: "findByTags";

package/dist/CallMethod.js

@@ -1,6 +1,7 @@
 // CallMethod 常量对象
 export const CallMethod = {
     takeScreenshot: "takeScreenshot",
+    takeScreenshotSave: "takeScreenshotSave",
     overlayToast: "overlayToast",
     setNodeText: "setNodeText",
     findByTags: "findByTags",

package/dist/filesystem/fileio/file-io.d.ts

@@ -48,10 +48,11 @@ export declare class FileIO {
      * @param filePath 文件路径
      * @param content 文件内容
      * @param append 是否追加，默认为 false
+     * @param threadSafe 是否线程安全写入，默认为 false
      * @param timeout 超时时间(秒)，默认30秒
      * @returns Promise<是否成功>
      */
-    writeFileFromString(filePath: string, content: string, append?: boolean, timeout?: number): Promise<boolean>;
+    writeFileFromString(filePath: string, content: string, append?: boolean, threadSafe?: boolean, timeout?: number): Promise<boolean>;
     /**
      * 读取文件为字符串列表
      * @param filePath 文件路径

package/dist/filesystem/fileio/file-io.js

@@ -132,12 +132,13 @@ export class FileIO {
      * @param filePath 文件路径
      * @param content 文件内容
      * @param append 是否追加，默认为 false
+     * @param threadSafe 是否线程安全写入，默认为 false
      * @param timeout 超时时间(秒)，默认30秒
      * @returns Promise<是否成功>
      */
-    async writeFileFromString(filePath, content, append = false, timeout) {
+    async writeFileFromString(filePath, content, append = false, threadSafe = false, timeout) {
         var _a;
-        const response = await this.asyncCall("writeFileFromString", { filePath, content, append }, timeout);
+        const response = await this.asyncCall("writeFileFromString", { filePath, content, append, threadSafe }, timeout);
         if (!response.isSuccess()) {
             throw new Error(((_a = response.data) === null || _a === void 0 ? void 0 : _a.message) || "Write file from string failed");
         }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "assistsx-js",
-    "version": "0.0.3008",
+    "version": "0.1.01",
     "description": "assistsx-js自动化开发SDK",
     "main": "dist/index.js",
     "module": "dist/index.js",

package/src/AssistsXAsync.ts

@@ -217,6 +217,43 @@ export class AssistsXAsync {
         const data = response.getDataOrDefault({ images: [] });
         return data.images;
     }
+
+    /**
+     * 保存全屏截图到文件
+     * @param options 截图保存选项
+     * @param options.filePath 文件路径（可选，不提供则自动生成）
+     * @param options.format 图片格式，支持 "PNG"、"JPEG"、"JPG"、"WEBP"，默认为 "PNG"
+     * @param options.overlayHiddenScreenshotDelayMillis 截图延迟时间(毫秒)，默认为 250
+     * @param options.timeout 超时时间(秒)，默认30秒
+     * @returns 保存的文件路径
+     */
+    public static async takeScreenshotSave(
+        options: {
+            filePath?: string;
+            format?: "PNG" | "JPEG" | "JPG" | "WEBP";
+            overlayHiddenScreenshotDelayMillis?: number;
+            timeout?: number;
+        } = {}
+    ): Promise<string> {
+        const {
+            filePath,
+            format = "PNG",
+            overlayHiddenScreenshotDelayMillis = 250,
+            timeout,
+        } = options;
+
+        const response = await this.asyncCall(CallMethod.takeScreenshotSave, {
+            args: {
+                filePath,
+                format,
+                overlayHiddenScreenshotDelayMillis,
+            },
+            timeout,
+        });
+        const data = response.getDataOrDefault({ file: "" });
+        return data.file;
+    }
+
     /**
      * 截图识别文本
      * @param param0 识别参数

package/src/CallMethod.ts

@@ -1,6 +1,7 @@
 // CallMethod 常量对象
 export const CallMethod = {
     takeScreenshot: "takeScreenshot",
+    takeScreenshotSave: "takeScreenshotSave",
     overlayToast: "overlayToast",
     setNodeText: "setNodeText",
     findByTags: "findByTags",

package/src/filesystem/fileio/file-io.ts

@@ -177,6 +177,7 @@ export class FileIO {
      * @param filePath 文件路径
      * @param content 文件内容
      * @param append 是否追加，默认为 false
+     * @param threadSafe 是否线程安全写入，默认为 false
      * @param timeout 超时时间(秒)，默认30秒
      * @returns Promise<是否成功>
      */
@@ -184,11 +185,12 @@ export class FileIO {
         filePath: string,
         content: string,
         append: boolean = false,
+        threadSafe: boolean = false,
         timeout?: number
     ): Promise<boolean> {
         const response = await this.asyncCall(
             "writeFileFromString",
-            { filePath, content, append },
+            { filePath, content, append, threadSafe },
             timeout
         );
         if (!response.isSuccess()) {