@bettergi/utils 0.1.20 → 0.1.21

package/README.md

@@ -126,22 +126,32 @@ await assertRegionDisappearing(findButton, "点击购买按钮超时", () => fin
 > 对常见鼠标操作的封装，如鼠标的平滑移动、鼠标滚轮滚动、鼠标拖拽等。
 
 ```ts
-// 鼠标从 (745, 610) 平滑自然地移动 (1920, 1080)
-await naturalMouseMove(745, 610, 1920, 1080);
+// 鼠标沿路径点移动并拖拽
+await mouseMoveAlongWaypoints(
+  [
+    { x: 100, y: 100 },
+    { x: 200, y: 200 },
+    { x: 300, y: 300 }
+  ],
+  { shouldDrag: true }
+);
 
 // 鼠标从 (745, 610) 拖拽到 (1280, 610)
 await mouseDrag(745, 610, 1280, 610);
 
+// 鼠标从 (745, 610) 平滑自然地移动 (1920, 1080)
+await naturalMouseMove(745, 610, 1920, 1080);
+
 // 鼠标滚轮向上滚动 175 像素
 await mouseScrollUp(175);
 
 // 鼠标滚轮向下滚动 175 像素
 await mouseScrollDown(175);
 
-// 鼠标滚轮向上滚动 99 行，行高 175（默认: 背包物品行高）
+// 鼠标滚轮向上滚动 99 行（默认: 175为背包物品行高）
 await mouseScrollUpLines(99);
 
-// 鼠标滚轮向下滚动 1 行，行高 115（自定义: 商店物品行高）
+// 鼠标滚轮向下滚动 1 行（自定义: 115为商店物品行高）
 await mouseScrollDownLines(1, 115);
 ```
 
@@ -201,12 +211,14 @@ tracker.complete(`任务完成`);
 
 ```ts
 // 发送 GET 请求获取响应体内容
-const body1 = await getForBody("https://example.com/", undefined, { "User-Agent": "BetterGI" });
-log.info(`GET 请求响应体内容${body1}`);
+const body1 = await getForBody("https://jsonplaceholder.typicode.com/todos/1");
 
 // 发送 POST 请求获取响应体内容
-const body2 = await postForBody("https://example.com/", undefined, { "User-Agent": "BetterGI" });
-log.info(`POST 请求响应体内容${body2}`);
+const body2 = await postForBody("https://jsonplaceholder.typicode.com/posts", {
+  title: "foo",
+  body: "bar",
+  userId: 1
+});
 ```
 
 ### 文件操作

package/dist/http.d.ts

@@ -2,24 +2,24 @@
  * 发送 HTTP 请求，获取响应体内容
  * @param method 请求方法
  * @param url 请求 URL
- * @param body 请求体
+ * @param body 请求体（UTF-8 编码）
  * @param headers 请求头
  * @returns 响应体内容
  */
-export declare const requestForBody: (method: Parameters<typeof http.request>[0], url: string, body?: string, headers?: Record<string, any>) => Promise<string>;
+export declare const requestForBody: (method: Parameters<typeof http.request>[0], url: string, body?: string | object, headers?: Record<string, any>) => Promise<string>;
 /**
  * 发送 HTTP GET 请求，获取响应体内容
  * @param url 请求 URL
- * @param body 请求体
+ * @param body 请求体（UTF-8 编码）
  * @param headers 请求头
  * @returns 响应体内容
  */
-export declare const getForBody: (url: string, body?: string, headers?: Record<string, any>) => Promise<string>;
+export declare const getForBody: (url: string, body?: string | object, headers?: Record<string, any>) => Promise<string>;
 /**
  * 发送 HTTP POST 请求，获取响应体内容
  * @param url 请求 URL
- * @param body 请求体
+ * @param body 请求体（UTF-8 编码）
  * @param headers 请求头
  * @returns 响应体内容
  */
-export declare const postForBody: (url: string, body?: string, headers?: Record<string, any>) => Promise<string>;
+export declare const postForBody: (url: string, body?: string | object, headers?: Record<string, any>) => Promise<string>;

package/dist/http.js

@@ -2,33 +2,37 @@
  * 发送 HTTP 请求，获取响应体内容
  * @param method 请求方法
  * @param url 请求 URL
- * @param body 请求体
+ * @param body 请求体（UTF-8 编码）
  * @param headers 请求头
  * @returns 响应体内容
  */
 export const requestForBody = async (method, url, body, headers) => {
-    const resp = await http.request(method, url, body ?? "null", headers ? JSON.stringify(headers) : "null");
+    if (body && typeof body === "object") {
+        body = JSON.stringify(body);
+        headers = { ...headers, "Content-Type": "application/json" };
+    }
+    const resp = await http.request(method, url, body ?? null, headers ? JSON.stringify(headers) : null);
     if (resp.status_code >= 200 && resp.status_code < 400) {
         return resp.body;
     }
     else {
-        throw new Error(`HTTP request failed with status ${resp.status_code}`);
+        throw new Error(`HTTP request failed with status ${resp.status_code}: ${resp.body}`);
     }
 };
 /**
  * 发送 HTTP GET 请求，获取响应体内容
  * @param url 请求 URL
- * @param body 请求体
+ * @param body 请求体（UTF-8 编码）
  * @param headers 请求头
  * @returns 响应体内容
  */
-export const getForBody = async (url, body, headers) => {
+export const getForBody = (url, body, headers) => {
     return requestForBody("GET", url, body, headers);
 };
 /**
  * 发送 HTTP POST 请求，获取响应体内容
  * @param url 请求 URL
- * @param body 请求体
+ * @param body 请求体（UTF-8 编码）
  * @param headers 请求头
  * @returns 响应体内容
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bettergi/utils",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "开发 BetterGI 脚本常用工具集",
   "type": "module",
   "author": "Bread Grocery<https://github.com/breadgrocery>",