tools_dj 1.0.93 → 1.0.94

package/README.md

@@ -53,7 +53,7 @@ const http = new Request({
 is([1, 2, 3]); // "Array"
 is({}); // "Object"
 is("hello"); // "String"
-```
+```[README.md](README.md)
 
 #### `is_empty(obj: any): boolean`
 判断值是否为空，支持所有数据类型
@@ -223,6 +223,13 @@ numberFixed(3.14159, 2); // 3.14
 numberRepair('5', 3, '0'); // "005"
 ```
 
+#### `Number.prototype.repair(n: number): string`
+数字原型方法补位
+```typescript
+(5).repair(3); // "005"
+(42).repair(4); // "0042"
+```
+
 #### `randomNumber(min: number, max: number): number`
 生成随机数
 ```typescript
@@ -465,6 +472,59 @@ const merged = mergeObj([
 time_change('2024-03-24 10:30'); // 1711252200000
 ```
 
+### 剪贴板操作
+
+#### `copyText(text: string): Promise<boolean>`
+复制文字到剪贴板
+```typescript
+import { copyText } from "tools_dj/clipboard";
+
+// 复制文本
+const success = await copyText('要复制的文本');
+console.log(success); // true 或 false
+```
+
+#### `isClipboardSupported(): boolean`
+检查浏览器是否支持剪贴板 API
+```typescript
+import { isClipboardSupported } from "tools_dj/clipboard";
+
+if (isClipboardSupported()) {
+  console.log('支持剪贴板 API');
+}
+```
+
+#### `readText(): Promise<string>`
+从剪贴板读取文本
+```typescript
+import { readText } from "tools_dj/clipboard";
+
+// 读取剪贴板内容
+const text = await readText();
+console.log(text);
+```
+
+### 数据获取
+
+#### `getDeepData(data: object, path: string, defaultValue: any): any`
+获取对象的深层属性值，支持点分路径
+```typescript
+import { getDeepData } from "tools_dj/data";
+
+const obj = {
+  user: {
+    name: 'Tom',
+    address: {
+      city: 'Beijing'
+    }
+  }
+};
+
+getDeepData(obj, 'user.name'); // 'Tom'
+getDeepData(obj, 'user.address.city'); // 'Beijing'
+getDeepData(obj, 'user.age', 18); // 18 (未找到时返回默认值)
+```
+
 ## 类模块
 
 ### 权限管理 (auth)

package/lib/request.d.ts

@@ -1,52 +1,12 @@
-/**
- * 请求配置接口
- */
-export interface conf {
-    /** 请求的基础URL前缀 */
-    baseUrl?: string;
-    /** 请求超时时间，单位毫秒，默认6000ms */
-    timeout?: number;
-    /** 请求成功后的回调函数，可以处理响应数据 */
-    callback?: (response: Response, conf: conf) => Promise<any> | any;
-    /** 请求失败时的错误处理回调函数 */
-    errBack?: (error: Error) => void;
-    /** 获取AbortController实例的回调，用于手动中断请求 */
-    abController?: (controller: AbortController) => void;
-    /** 请求发送前的预处理回调，可以修改请求选项 */
-    beforeBack?: (options: any) => void;
-}
-/**
- * Fetch请求客户端类
- * @description 基于fetch API的HTTP请求封装，支持超时、拦截器、错误处理等功能
- * 支持的fetch配置项：
- * - method: HTTP请求方法 (GET, POST, PUT, DELETE等)
- * - mode: 跨域策略 ("cors", "same-origin", "no-cors")
- * - cache: 缓存策略 ("no-cache", "default", "reload", "force-cache")
- * - credentials: 凭证策略 ("same-origin", "include", "omit")
- * - headers: 请求头，如 {"Content-Type": "application/json"}
- * - redirect: 重定向处理 ("follow", "manual", "error")
- * - referrerPolicy: 引用策略 ("no-referrer", "origin", "strict-origin")
- * - body: 请求体，通常使用 JSON.stringify(data) 转换对象
- * @author DJ
- * @since 2025/3/31
- */
+import { RequestConf, RequestOptions } from "./types";
+/** Fetch请求客户端类 */
 export default class {
-    options: any;
-    conf: conf;
-    /** 2024/12/24 10:07  User: DJ
-     * content: 请求处理
-     * @param option 请求头配置参数
-     * @param conf 配置
-     * @param conf.callback 成功回调
-     * @param conf.errBack 失败回调
-     * @param conf.abController 配置中断控制
-     * @param conf.timeout 超时
-     * @param conf.baseUrl 前缀
-     * @param conf.beforeBack (arg:newOptions) 请求前回调 可以设置数据
-     */
-    constructor(option?: any, conf?: conf);
-    /** 2025/3/28 15:55  User: DJ
-     * content: 创建服务
-     */
-    serve(url?: string, options?: any, conf?: conf): Promise<any>;
+    options: RequestOptions;
+    conf: RequestConf;
+    /** 请求处理 */
+    constructor(option?: RequestOptions, conf?: RequestConf);
+    /** 创建服务 */
+    serve(url?: string, options?: RequestOptions, conf?: RequestConf): Promise<any>;
 }
+/** @deprecated 使用 RequestConf 代替 */
+export type conf = RequestConf;

package/lib/types.d.ts

@@ -7,3 +7,41 @@ export interface formatSizeOptions {
     /** 转换进制，默认为1024 */
     perUnit?: number;
 }
+/** HTTP请求方法类型 */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS' | 'CONNECT' | 'TRACE';
+/** 跨域策略类型 */
+export type RequestMode = 'cors' | 'same-origin' | 'no-cors';
+/** 缓存策略类型 */
+export type RequestCache = 'no-cache' | 'default' | 'reload' | 'force-cache' | 'only-if-cached';
+/** 凭证策略类型 */
+export type RequestCredentials = 'same-origin' | 'include' | 'omit';
+/** 重定向处理类型 */
+export type RequestRedirect = 'follow' | 'manual' | 'error';
+/** 引用策略类型 */
+export type ReferrerPolicy = 'no-referrer' | 'no-referrer-when-downgrade' | 'origin' | 'origin-when-cross-origin' | 'same-origin' | 'strict-origin' | 'strict-origin-when-cross-origin' | 'unsafe-url';
+/** 请求头类型 */
+export type RequestHeaders = Record<string, string> | Headers;
+/** 请求选项接口 */
+export interface RequestOptions {
+    method?: HttpMethod;
+    mode?: RequestMode;
+    cache?: RequestCache;
+    credentials?: RequestCredentials;
+    headers?: RequestHeaders;
+    redirect?: RequestRedirect;
+    referrerPolicy?: ReferrerPolicy;
+    body?: BodyInit | null;
+    referrer?: string;
+    signal?: AbortSignal;
+    window?: null;
+    [key: string]: any;
+}
+/** 请求配置接口 */
+export interface RequestConf {
+    baseUrl?: string;
+    timeout?: number;
+    callback?: (response: Response, conf: RequestConf) => Promise<any> | any;
+    errBack?: (error: Error) => void;
+    abController?: (controller: AbortController) => void;
+    beforeBack?: (options: RequestOptions) => void;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tools_dj",
-  "version": "1.0.93",
+  "version": "1.0.94",
   "description": "dj tools 工具库",
   "main": "./lib/index.js",
   "module": "./lib/index.js",