@base-web-kits/base-tools-web 1.3.6 → 1.3.10

package/README.md

@@ -98,3 +98,82 @@ setBaseToolsConfig({
   </body>
 </html>
 ```
+
+## 🤖 AI 智能助手 (Skill)
+
+本项目提供了强大的 AI Skill，可让 Cursor、Trae、Claude Code 等 AI 助手深度理解 `@base-web-kits` 的能力，为您精准推荐最佳实践函数，并自动处理依赖安装。
+
+### 安装方式
+
+在项目根目录下执行以下命令：
+
+```bash
+npx skills add gancao-web/base-tools
+```
+
+### 验证生效
+
+安装完成后，可以在对话框中输入以下问题进行测试。如果 AI 推荐了 `@base-web-kits` 下的相关包或函数，说明配置已生效。
+
+| 测试场景 | 推荐提问 | 预期 AI 回答 |
+| :-- | :-- | :-- |
+| **JS工具库** | "我需要深拷贝一个对象,请编写或推荐一个函数,优先考虑已配置的skill" | 推荐使用 `base-tools-ts` 的 `cloneDeep` |
+| **JS正则验证** | "我需要校验邮箱格式,请编写或推荐一个函数,优先考虑已配置的skill" | 推荐使用 `base-tools-ts` 的 `isEmail` |
+| **通用web** | "我需要复制文本到剪贴板,请编写或推荐一个函数,优先考虑已配置的skill" | 推荐使用 `base-tools-web` 的 `copyText` |
+| **React项目** | "我需要监听dom元素的尺寸变化,请编写或推荐一个函数,优先考虑已配置的skill" | 推荐使用 `base-tools-react` 的 `useSize` |
+| **Vue项目** | "我需要监听元素外部点击事件,请编写或推荐一个函数,优先考虑已配置的skill" | 推荐使用 `base-tools-vue` 的 `onClickOutside` |
+| **UniApp项目** | "我需要保存网络图片到系统相册,请编写或推荐一个函数,优先考虑已配置的skill" | 推荐使用 `base-tools-uni` 的 `saveImageToPhotosAlbum` 函数 |
+
+## 兼容性
+
+本工具库和相关依赖可能涉及的新特性及其最低兼容版本：
+
+| 特性                                     | ES 版本 | 最低兼容版本 (Browser/OS)           |
+| :--------------------------------------- | :------ | :---------------------------------- |
+| **Object.values / entries**              | ES2017  | Chrome 54+, iOS 10.3+, Android 7.0+ |
+| **String.prototype.padStart / padEnd**   | ES2017  | Chrome 57+, iOS 10.3+, Android 8.0+ |
+| **Object.getOwnPropertyDescriptors**     | ES2017  | Chrome 54+, iOS 10.3+, Android 7.0+ |
+| **Promise.prototype.finally**            | ES2018  | Chrome 63+, iOS 11.3+, Android 9.0+ |
+| **Symbol.asyncIterator**                 | ES2018  | Chrome 63+, iOS 12.0+, Android 9.0+ |
+| **Object.fromEntries**                   | ES2019  | Chrome 73+, iOS 12.2+, Android 10+  |
+| **Array.prototype.flat / flatMap**       | ES2019  | Chrome 69+, iOS 12.0+, Android 9.0+ |
+| **String.prototype.trimStart / trimEnd** | ES2019  | Chrome 66+, iOS 12.0+, Android 9.0+ |
+| **Promise.allSettled**                   | ES2020  | Chrome 76+, iOS 13.0+, Android 10+  |
+| **String.prototype.matchAll**            | ES2020  | Chrome 80+, iOS 13.0+, Android 10+  |
+| **BigInt**                               | ES2020  | Chrome 67+, iOS 14.0+, Android 11+  |
+| **globalThis**                           | ES2020  | Chrome 71+, iOS 12.2+, Android 9.0+ |
+| **String.prototype.replaceAll**          | ES2021  | Chrome 85+, iOS 13.4+, Android 11+  |
+| **Promise.any**                          | ES2021  | Chrome 85+, iOS 14.0+, Android 11+  |
+| **WeakRef / FinalizationRegistry**       | ES2021  | Chrome 84+, iOS 14.5+, Android 11+  |
+| **Array/String.prototype.at**            | ES2022  | Chrome 92+, iOS 15.4+, Android 12+  |
+| **Error.prototype.cause**                | ES2022  | Chrome 93+, iOS 15.0+, Android 12+  |
+| **Object.hasOwn**                        | ES2022  | Chrome 93+, iOS 15.4+, Android 12+  |
+
+本工具库构建目标为 **ES2015+**。但不内置 Polyfill, 如需支持低版本浏览器, 请务必在项目中配置 Polyfill。
+
+### 配置 Polyfill
+
+以 Vite 项目为例, 使用 `@vitejs/plugin-legacy` 插件自动按需注入 Polyfill。
+
+```ts
+// vite.config.ts
+import legacy from '@vitejs/plugin-legacy'; // 安装命令: npm install -D @vitejs/plugin-legacy
+
+export default {
+  plugins: [
+    legacy({
+      // 与antd4兼容性对齐 https://4x-ant-design.antgroup.com/docs/react/introduce-cn
+      // targets: ['defaults', 'not IE 11'],
+
+      // 与vant4兼容性对齐 https://vant4.ylhtest.com/#/zh-CN/home
+      // targets: ['chrome >= 51', 'android >= 5', 'ios >= 10'],
+
+      // 与Element对齐: https://element-plus.org/zh-CN/guide/installation
+      targets: ['Chrome >= 64', 'Edge >= 79', 'Firefox >= 78', 'Safari >= 12', 'not IE 11'],
+
+      // 按需自动引入polyfill (需使用vite3以上版本,因为vite2.x缺少新的ES特性,如Object.hasOwn)
+      modernPolyfills: true,
+    }),
+  ],
+};
+```

package/dist/base-tools-web.umd.global.js

@@ -2064,7 +2064,7 @@ var baseToolsWeb = (() => {
     onTaskReady == null ? void 0 : onTaskReady(task);
     return new Promise((resolve, reject) => {
       const execute = () => __async(null, null, function* () {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _i;
         const isGet = method === "GET";
         const isObjectData = isPlainObject(data);
         const isArrayData = !isObjectData && Array.isArray(data);
@@ -2118,7 +2118,7 @@ var baseToolsWeb = (() => {
           controller.abort();
         }, timeout);
         try {
-          const response = yield fetch(fillUrl, {
+          let response = yield fetch(fillUrl, {
             method,
             headers: fillHeader,
             body: fillBody,
@@ -2126,9 +2126,20 @@ var baseToolsWeb = (() => {
           });
           if (!response.ok) {
             if (showLoading) (_b = appConfig2.hideLoading) == null ? void 0 : _b.call(appConfig2);
-            throw new Error(`HTTP Error ${response.status}: ${response.statusText}`);
+            let errorText;
+            try {
+              errorText = yield response.text();
+              JSON.parse(errorText);
+            } catch (e) {
+              throw new Error(`HTTP Error ${response.status}`);
+            }
+            response = new Response(errorText, {
+              status: response.status,
+              statusText: response.statusText,
+              headers: response.headers
+            });
           }
-          if (enableChunked) {
+          if (enableChunked && response.ok) {
             if (showLoading) (_c = appConfig2.hideLoading) == null ? void 0 : _c.call(appConfig2);
             const res2 = yield handleStreamResponse(response, sseTask);
             logRequestInfo({ status: "success", config: logConfig, startTime, res: res2 });
@@ -2155,16 +2166,18 @@ var baseToolsWeb = (() => {
             reject(res);
           }
         } catch (e) {
+          if (showLoading) (_g = appConfig2.hideLoading) == null ? void 0 : _g.call(appConfig2);
           const status = "fail";
           const isAbortError = e instanceof DOMException && e.name === "AbortError";
           if (isAbortError && isTimeout) {
-            if (toastError) (_g = appConfig2.toast) == null ? void 0 : _g.call(appConfig2, { status, msg: "\u8BF7\u6C42\u8D85\u65F6" });
+            if (toastError) (_h = appConfig2.toast) == null ? void 0 : _h.call(appConfig2, { status, msg: "\u8BF7\u6C42\u8D85\u65F6" });
             const timeoutError = new Error("Request Timeout");
             logRequestInfo({ status, config: logConfig, startTime, e: timeoutError });
             reject(timeoutError);
             return;
           }
-          if (!isAbortError && toastError) (_h = appConfig2.toast) == null ? void 0 : _h.call(appConfig2, { status, msg: "\u7F51\u7EDC\u8BF7\u6C42\u5931\u8D25" });
+          if (!isAbortError && toastError)
+            (_i = appConfig2.toast) == null ? void 0 : _i.call(appConfig2, { status, msg: `\u8BF7\u6C42\u5931\u8D25,${String(e)}` });
           logRequestInfo({ status, config: logConfig, startTime, e });
           reject(e);
         } finally {
@@ -2214,7 +2227,7 @@ var baseToolsWeb = (() => {
       info.res = cloneDeep(res);
       log("info", info);
     } else {
-      info.e = e;
+      info.e = e instanceof Error ? { name: e.name, message: e.message, stack: e.stack } : String(e);
       log("error", info);
     }
   }