clickgo 7.4.0 → 7.4.1

package/doc/clickgo-rag.md

@@ -36533,7 +36533,7 @@ lib/tool/enumerations/ESTATE.md
 
 # Enumeration: ESTATE
 
-Defined in: [lib/tool.ts:593](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L593)
+Defined in: [lib/tool.ts:608](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L608)
 
 状态机状态
 
@@ -36543,7 +36543,7 @@ Defined in: [lib/tool.ts:593](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **COMMENT**: `4`
 
-Defined in: [lib/tool.ts:603](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L603)
+Defined in: [lib/tool.ts:618](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L618)
 
 注释
 
@@ -36553,7 +36553,7 @@ Defined in: [lib/tool.ts:603](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **NORMAL**: `0`
 
-Defined in: [lib/tool.ts:595](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L595)
+Defined in: [lib/tool.ts:610](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L610)
 
 普通
 
@@ -36563,7 +36563,7 @@ Defined in: [lib/tool.ts:595](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **REG**: `3`
 
-Defined in: [lib/tool.ts:601](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L601)
+Defined in: [lib/tool.ts:616](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L616)
 
 正则
 
@@ -36573,7 +36573,7 @@ Defined in: [lib/tool.ts:601](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **STRING**: `2`
 
-Defined in: [lib/tool.ts:599](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L599)
+Defined in: [lib/tool.ts:614](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L614)
 
 字符串
 
@@ -36583,7 +36583,7 @@ Defined in: [lib/tool.ts:599](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **WORD**: `1`
 
-Defined in: [lib/tool.ts:597](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L597)
+Defined in: [lib/tool.ts:612](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L612)
 
 单词
 
@@ -36600,7 +36600,7 @@ lib/tool/functions/blob2ArrayBuffer.md
 
 > **blob2ArrayBuffer**(`blob`): `Promise`\<`ArrayBuffer`\>
 
-Defined in: [lib/tool.ts:71](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L71)
+Defined in: [lib/tool.ts:86](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L86)
 
 将 blob 对象转换为 ArrayBuffer
 
@@ -36629,7 +36629,7 @@ lib/tool/functions/blob2DataUrl.md
 
 > **blob2DataUrl**(`blob`): `Promise`\<`string`\>
 
-Defined in: [lib/tool.ts:494](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L494)
+Defined in: [lib/tool.ts:509](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L509)
 
 将 blob 对象转换为 base64 url
 
@@ -36660,7 +36660,7 @@ lib/tool/functions/blob2Text.md
 
 > **blob2Text**(`blob`): `Promise`\<`string`\>
 
-Defined in: [lib/tool.ts:485](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L485)
+Defined in: [lib/tool.ts:500](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L500)
 
 将 blob 对象转换为 text
 
@@ -36689,7 +36689,7 @@ lib/tool/functions/clone.md
 
 > **clone**\<`T`\>(`obj`): `T`
 
-Defined in: [lib/tool.ts:98](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L98)
+Defined in: [lib/tool.ts:113](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L113)
 
 完整的克隆一份数组/对象
 
@@ -36726,7 +36726,7 @@ lib/tool/functions/compar.md
 
 > **compar**(`before`, `after`): `object`
 
-Defined in: [lib/tool.ts:507](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L507)
+Defined in: [lib/tool.ts:522](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L522)
 
 - 对比老值和新值，看看新值中哪些移除了，哪些新增了
 
@@ -36781,9 +36781,9 @@ lib/tool/functions/compressor.md
 
 > **compressor**\<`T`\>(`file`, `options?`): `Promise`\<`false` \| `T`\>
 
-Defined in: [lib/tool.ts:35](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L35)
+Defined in: [lib/tool.ts:57](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L57)
 
-压缩一个图片
+压缩图片，质量降档复用同一画布，保留方向校正及等比缩放
 
 ## Type Parameters
 
@@ -36797,33 +36797,30 @@ Defined in: [lib/tool.ts:35](https://github.com/maiyun/clickgo/blob/master/dist/
 
 `T`
 
-文件或 blob 类型
+图片文件或 Blob；File 输入返回 File，转换格式时同步扩展名和 MIME 类型
 
 ### options?
 
-参数
-
-#### maxHeight?
+[`ICompressorOptions`](../interfaces/ICompressorOptions.md) = `{}`
 
-`number`
+压缩参数
 
-最高高度，默认无限
-
-#### maxWidth?
-
-`number`
-
-最大宽度，默认无限
-
-#### quality?
+## Returns
 
-`number`
+`Promise`\<`false` \| `T`\>
 
-压缩质量，默认 0.8
+压缩后的图片；参数无效、加载或编码失败、指定格式不受支持或无法满足大小上限时返回 false
 
-## Returns
+## Example
 
-`Promise`\<`false` \| `T`\>
+```ts
+const image = await clickgo.tool.compressor(file, {
+    'mimeType': 'image/jpeg',
+    'maxWidth': 2000,
+    'quality': [0.9, 0.6, 0.5],
+    'maxSize': 2 * 1024 * 1024,
+});
+```
 
 lib/tool/functions/decodeText.md
 ---
@@ -36912,7 +36909,7 @@ lib/tool/functions/escapeHTML.md
 
 > **escapeHTML**(`html`): `string`
 
-Defined in: [lib/tool.ts:278](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L278)
+Defined in: [lib/tool.ts:293](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L293)
 
 转义 HTML
 
@@ -36941,7 +36938,7 @@ lib/tool/functions/eventsAttrWrap.md
 
 > **eventsAttrWrap**(`layout`): `string`
 
-Defined in: [lib/tool.ts:188](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L188)
+Defined in: [lib/tool.ts:203](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L203)
 
 对 layout 的 events 事件进行包裹
 
@@ -36970,7 +36967,7 @@ lib/tool/functions/execCommand.md
 
 > **execCommand**(`ac`): `void`
 
-Defined in: [lib/tool.ts:498](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L498)
+Defined in: [lib/tool.ts:513](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L513)
 
 ## Parameters
 
@@ -36995,7 +36992,7 @@ lib/tool/functions/fetch.md
 
 > **fetch**(`url`, `init?`): `Promise`\<`string` \| `Blob` \| `null`\>
 
-Defined in: [lib/tool.ts:377](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L377)
+Defined in: [lib/tool.ts:392](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L392)
 
 发起 fetch 请求
 
@@ -37032,7 +37029,7 @@ lib/tool/functions/formatColor.md
 
 > **formatColor**(`color`): `number`[]
 
-Defined in: [lib/tool.ts:294](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L294)
+Defined in: [lib/tool.ts:309](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L309)
 
 将 rgb 或 hsl 等颜色转换为数字数组
 
@@ -37061,7 +37058,7 @@ lib/tool/functions/formatSecond.md
 
 > **formatSecond**(`second`): `string`
 
-Defined in: [lib/tool.ts:519](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L519)
+Defined in: [lib/tool.ts:534](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L534)
 
 将秒数格式化为 0:0:0 的字符串
 
@@ -37088,7 +37085,7 @@ lib/tool/functions/formatTime.md
 
 > **formatTime**(`ts`, `tz?`): `object`
 
-Defined in: [lib/tool.ts:528](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L528)
+Defined in: [lib/tool.ts:543](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L543)
 
 将日期对象或毫秒级时间戳转换为字符串
 
@@ -37135,7 +37132,7 @@ lib/tool/functions/getArray.md
 
 > **getArray**(`param`): `any`[]
 
-Defined in: [lib/tool.ts:270](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L270)
+Defined in: [lib/tool.ts:285](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L285)
 
 根据参数获取最终的数组型，可传入类似 [1,2,3] 或 1,2,3
 
@@ -37164,7 +37161,7 @@ lib/tool/functions/getBoolean.md
 
 > **getBoolean**(`param`): `boolean`
 
-Defined in: [lib/tool.ts:254](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L254)
+Defined in: [lib/tool.ts:269](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L269)
 
 根据参数获取最终的布尔值
 
@@ -37193,7 +37190,7 @@ lib/tool/functions/getClassPrototype.md
 
 > **getClassPrototype**(`obj`, `over?`, `level?`): [`IClassPrototype`](../interfaces/IClassPrototype.md)
 
-Defined in: [lib/tool.ts:63](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L63)
+Defined in: [lib/tool.ts:78](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L78)
 
 获取 class 的所有 method 和 get/set
 
@@ -37234,7 +37231,7 @@ lib/tool/functions/get.md
 
 > **get**(`url`, `init?`, `opt?`): `Promise`\<`string` \| `Blob` \| `null`\>
 
-Defined in: [lib/tool.ts:388](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L388)
+Defined in: [lib/tool.ts:403](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L403)
 
 发起 GET 请求
 
@@ -37281,7 +37278,7 @@ lib/tool/functions/getMimeByPath.md
 
 > **getMimeByPath**(`path`): `object`
 
-Defined in: [lib/tool.ts:214](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L214)
+Defined in: [lib/tool.ts:229](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L229)
 
 根据后缀、文件名或路径获取 mime 类型（简单版，完整版请使用 @litert/mime.js）
 
@@ -37318,7 +37315,7 @@ lib/tool/functions/getNumber.md
 
 > **getNumber**(`param`): `number`
 
-Defined in: [lib/tool.ts:262](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L262)
+Defined in: [lib/tool.ts:277](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L277)
 
 根据参数获取最终的数字型
 
@@ -37347,7 +37344,7 @@ lib/tool/functions/getResponseJson.md
 
 > **getResponseJson**(`url`, `init?`): `Promise`\<`any`\>
 
-Defined in: [lib/tool.ts:414](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L414)
+Defined in: [lib/tool.ts:429](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L429)
 
 发起 GET 请求并解析 JSON 响应
 
@@ -37384,7 +37381,7 @@ lib/tool/functions/hex2rgb.md
 
 > **hex2rgb**(`hex`): `object`
 
-Defined in: [lib/tool.ts:312](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L312)
+Defined in: [lib/tool.ts:327](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L327)
 
 hex 转换为 rgba，#27ae60ff, 27ae60 #fff
 
@@ -37433,7 +37430,7 @@ lib/tool/functions/hsl2rgb.md
 
 > **hsl2rgb**(`h`, `s?`, `l?`, `a?`, `decimal?`): `object`
 
-Defined in: [lib/tool.ts:350](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L350)
+Defined in: [lib/tool.ts:365](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L365)
 
 hsl 字符串转 rgb 数组
 
@@ -37506,7 +37503,7 @@ lib/tool/functions/isEscapeChar.md
 
 > **isEscapeChar**(`code`, `index`): `boolean`
 
-Defined in: [lib/tool.ts:588](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L588)
+Defined in: [lib/tool.ts:603](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L603)
 
 判断字符是否是转义字符
 
@@ -37543,7 +37540,7 @@ lib/tool/functions/isEscaped.md
 
 > **isEscaped**(`str`, `pos`): `boolean`
 
-Defined in: [lib/tool.ts:568](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L568)
+Defined in: [lib/tool.ts:583](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L583)
 
 转义字符检查
 检查指定位置的字符是否被转义
@@ -37581,7 +37578,7 @@ lib/tool/functions/isFalsy.md
 
 > **isFalsy**(`val`): `val is TFalsy`
 
-Defined in: [lib/tool.ts:713](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L713)
+Defined in: [lib/tool.ts:728](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L728)
 
 判断一个值是否是虚假的（为 null/undefined/空字符串/false/0）
 
@@ -37610,7 +37607,7 @@ lib/tool/functions/isJson.md
 
 > **isJson**(`value`): `value is TJson`
 
-Defined in: [lib/tool.ts:705](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L705)
+Defined in: [lib/tool.ts:720](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L720)
 
 判断 JS 值是否符合 JSON 数据约束；字符串按数据值接受，不解析其内容
 
@@ -37641,7 +37638,7 @@ lib/tool/functions/isMs.md
 
 > **isMs**(`time`): `boolean`
 
-Defined in: [lib/tool.ts:540](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L540)
+Defined in: [lib/tool.ts:555](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L555)
 
 是否是毫秒
 
@@ -37670,7 +37667,7 @@ lib/tool/functions/isTruthy.md
 
 > **isTruthy**(`val`): `val is any`
 
-Defined in: [lib/tool.ts:721](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L721)
+Defined in: [lib/tool.ts:736](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L736)
 
 判断一个值是否是真实的（不为 null/undefined/空字符串/false/0）
 
@@ -37699,7 +37696,7 @@ lib/tool/functions/layoutAddTagClassAndReTagName.md
 
 > **layoutAddTagClassAndReTagName**(`layout`, `retagname`): `string`
 
-Defined in: [lib/tool.ts:161](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L161)
+Defined in: [lib/tool.ts:176](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L176)
 
 给标签增加 tag-tagname 的 class，同时给标签增加 cg- 前导（仅字符串，不是操作真实 dom）
 
@@ -37734,7 +37731,7 @@ lib/tool/functions/layoutClassPrepend.md
 
 > **layoutClassPrepend**(`layout`, `preps`): `string`
 
-Defined in: [lib/tool.ts:180](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L180)
+Defined in: [lib/tool.ts:195](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L195)
 
 给 class 增加 scope 的随机前缀，给 id 新增前缀
 
@@ -37769,7 +37766,7 @@ lib/tool/functions/layoutInsertAttr.md
 
 > **layoutInsertAttr**(`layout`, `insert`, `opt?`): `string`
 
-Defined in: [lib/tool.ts:171](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L171)
+Defined in: [lib/tool.ts:186](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L186)
 
 给标签追加 attr，即使 attr 存在也会追加上一个新的（非真实 DOM 操作，仅仅是对字符串进行处理）
 
@@ -37816,7 +37813,7 @@ lib/tool/functions/loadAssets.md
 
 > **loadAssets**(`urls`, `opt?`): `Promise`\<`boolean`\>
 
-Defined in: [lib/tool.ts:686](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L686)
+Defined in: [lib/tool.ts:701](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L701)
 
 批量并行加载 JS 和 CSS；JS 按列表顺序执行，CSS 按列表顺序插入
 
@@ -37855,7 +37852,7 @@ lib/tool/functions/loadLink.md
 
 > **loadLink**(`url`, `pos?`): `Promise`\<`boolean`\>
 
-Defined in: [lib/tool.ts:665](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L665)
+Defined in: [lib/tool.ts:680](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L680)
 
 加载 css 文件
 
@@ -37890,7 +37887,7 @@ lib/tool/functions/loadLinks.md
 
 > **loadLinks**(`urls`, `opt?`): `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:674](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L674)
+Defined in: [lib/tool.ts:689](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L689)
 
 批量加载 css 文件
 
@@ -37927,7 +37924,7 @@ lib/tool/functions/loadScript.md
 
 > **loadScript**(`url`, `ordered?`): `Promise`\<`boolean`\>
 
-Defined in: [lib/tool.ts:643](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L643)
+Defined in: [lib/tool.ts:658](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L658)
 
 加载脚本
 
@@ -37964,7 +37961,7 @@ lib/tool/functions/loadScripts.md
 
 > **loadScripts**(`urls`, `opt?`): `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:652](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L652)
+Defined in: [lib/tool.ts:667](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L667)
 
 批量加载 js 文件
 
@@ -38007,7 +38004,7 @@ lib/tool/functions/loadStyle.md
 
 > **loadStyle**(`style`): `void`
 
-Defined in: [lib/tool.ts:696](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L696)
+Defined in: [lib/tool.ts:711](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L711)
 
 加载 css 字符串
 
@@ -38036,7 +38033,7 @@ lib/tool/functions/logicalOr.md
 
 > **logicalOr**\<`T`, `T2`\>(`v1`, `v2`): \[`T`\] *extends* \[[`TFalsy`](../type-aliases/TFalsy.md)\] ? `T2` : `T`
 
-Defined in: [lib/tool.ts:730](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L730)
+Defined in: [lib/tool.ts:745](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L745)
 
 类似 || 运算符的效果
 
@@ -38081,7 +38078,7 @@ lib/tool/functions/match.md
 
 > **match**(`str`, `regs`): `boolean`
 
-Defined in: [lib/tool.ts:138](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L138)
+Defined in: [lib/tool.ts:153](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L153)
 
 传入正则进行匹配 str 是否有一项满足
 
@@ -38116,7 +38113,7 @@ lib/tool/functions/nextFrame.md
 
 > **nextFrame**(): `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:113](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L113)
+Defined in: [lib/tool.ts:128](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L128)
 
 等待浏览器帧
 
@@ -38137,7 +38134,7 @@ lib/tool/functions/parseArrayString.md
 
 > **parseArrayString**(`arrayStr`): `string`[]
 
-Defined in: [lib/tool.ts:578](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L578)
+Defined in: [lib/tool.ts:593](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L593)
 
 数组字符串解析器
 解析数组字符串为各元素组成的字符串数组
@@ -38169,7 +38166,7 @@ lib/tool/functions/parseUrl.md
 
 > **parseUrl**(`url`): [`IUrl`](../interfaces/IUrl.md)
 
-Defined in: [lib/tool.ts:463](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L463)
+Defined in: [lib/tool.ts:478](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L478)
 
 传输 url 并解析为 IUrl 对象
 
@@ -38198,7 +38195,7 @@ lib/tool/functions/post.md
 
 > **post**(`url`, `data`, `init?`): `Promise`\<`string` \| `Blob` \| `null`\>
 
-Defined in: [lib/tool.ts:402](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L402)
+Defined in: [lib/tool.ts:417](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L417)
 
 发起 POST 请求（除 FormData 外都会转换为 JSON 提交）
 
@@ -38241,7 +38238,7 @@ lib/tool/functions/postResponseEventStream.md
 
 > **postResponseEventStream**(`url`, `data`, `opts?`): `AbortController`
 
-Defined in: [lib/tool.ts:425](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L425)
+Defined in: [lib/tool.ts:440](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L440)
 
 发起 JSON 请求并获得文本 SSE 响应
 
@@ -38316,7 +38313,7 @@ lib/tool/functions/postResponseJson.md
 
 > **postResponseJson**(`url`, `data`, `init?`): `Promise`\<`any`\>
 
-Defined in: [lib/tool.ts:453](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L453)
+Defined in: [lib/tool.ts:468](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L468)
 
 发起 POST 请求并解析 JSON 响应
 
@@ -38359,7 +38356,7 @@ lib/tool/functions/purify.md
 
 > **purify**(`text`): `string`
 
-Defined in: [lib/tool.ts:129](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L129)
+Defined in: [lib/tool.ts:144](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L144)
 
 去除 html 的空白符、换行以及注释
 
@@ -38388,7 +38385,7 @@ lib/tool/functions/queryParse.md
 
 > **queryParse**(`query`): `Record`\<`string`, `string` \| `string`[]\>
 
-Defined in: [lib/tool.ts:557](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L557)
+Defined in: [lib/tool.ts:572](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L572)
 
 将 query string 转换为对象
 
@@ -38417,7 +38414,7 @@ lib/tool/functions/queryStringify.md
 
 > **queryStringify**(`query`, `encode?`): `string`
 
-Defined in: [lib/tool.ts:549](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L549)
+Defined in: [lib/tool.ts:564](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L564)
 
 将对象转换为 query string
 
@@ -38452,7 +38449,7 @@ lib/tool/functions/rand.md
 
 > **rand**(`min`, `max`, `prec?`): `number`
 
-Defined in: [lib/tool.ts:224](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L224)
+Defined in: [lib/tool.ts:239](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L239)
 
 生成范围内的随机数
 
@@ -38493,7 +38490,7 @@ lib/tool/functions/random.md
 
 > **random**(`length?`, `source?`, `block?`): `string`
 
-Defined in: [lib/tool.ts:246](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L246)
+Defined in: [lib/tool.ts:261](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L261)
 
 生成随机字符串
 
@@ -38536,7 +38533,7 @@ lib/tool/functions/request.md
 
 > **request**(`url`, `opt`): `Promise`\<`any`\>
 
-Defined in: [lib/tool.ts:367](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L367)
+Defined in: [lib/tool.ts:382](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L382)
 
 发起一个网络请求，若是返回值是 JSON 则自动解析，否则直接返回字符串
 
@@ -38571,7 +38568,7 @@ lib/tool/functions/rgb2hex.md
 
 > **rgb2hex**(`r`, `g?`, `b?`, `a?`): `string`
 
-Defined in: [lib/tool.ts:304](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L304)
+Defined in: [lib/tool.ts:319](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L319)
 
 将 r, g, b 转换为 hex 字符串，不含 #
 
@@ -38616,7 +38613,7 @@ lib/tool/functions/rgb2hsl.md
 
 > **rgb2hsl**(`r`, `g?`, `b?`, `a?`, `decimal?`): `object`
 
-Defined in: [lib/tool.ts:330](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L330)
+Defined in: [lib/tool.ts:345](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L345)
 
 rgb 字符串转 hsl 数组
 
@@ -38720,7 +38717,7 @@ lib/tool/functions/sizeFormat.md
 
 > **sizeFormat**(`size`, `spliter?`): `string`
 
-Defined in: [lib/tool.ts:80](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L80)
+Defined in: [lib/tool.ts:95](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L95)
 
 将文件大小格式化为带单位的字符串
 
@@ -38755,7 +38752,7 @@ lib/tool/functions/sleepFrame.md
 
 > **sleepFrame**(`count`): `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:121](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L121)
+Defined in: [lib/tool.ts:136](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L136)
 
 等待浏览器帧
 
@@ -38784,7 +38781,7 @@ lib/tool/functions/sleep.md
 
 > **sleep**(`ms?`): `Promise`\<`boolean`\>
 
-Defined in: [lib/tool.ts:106](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L106)
+Defined in: [lib/tool.ts:121](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L121)
 
 等待毫秒
 
@@ -38813,7 +38810,7 @@ lib/tool/functions/stateMachine.md
 
 > **stateMachine**(`code`, `start`, `process`): `void`
 
-Defined in: [lib/tool.ts:613](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L613)
+Defined in: [lib/tool.ts:628](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L628)
 
 源码分段状态机，单词按 ASCII 字母、数字、_ 和 $ 识别
 
@@ -38856,7 +38853,7 @@ lib/tool/functions/stylePrepend.md
 
 > **stylePrepend**(`style`, `prep?`): `object`
 
-Defined in: [lib/tool.ts:206](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L206)
+Defined in: [lib/tool.ts:221](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L221)
 
 给 class 前部增加唯一标识符
 
@@ -38899,7 +38896,7 @@ lib/tool/functions/styleUrl2DataUrl.md
 
 > **styleUrl2DataUrl**(`path`, `style`, `files`): `Promise`\<`string`\>
 
-Defined in: [lib/tool.ts:148](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L148)
+Defined in: [lib/tool.ts:163](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L163)
 
 将 style 中的 url 转换成 base64 data url
 
@@ -38940,7 +38937,7 @@ lib/tool/functions/teleportGlue.md
 
 > **teleportGlue**(`layout`, `formId`): `string`
 
-Defined in: [lib/tool.ts:197](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L197)
+Defined in: [lib/tool.ts:212](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L212)
 
 对 layout 的 teleport 做转义处理为 vue 识别的内容
 
@@ -38975,7 +38972,7 @@ lib/tool/functions/unescapeHTML.md
 
 > **unescapeHTML**(`html`): `string`
 
-Defined in: [lib/tool.ts:286](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L286)
+Defined in: [lib/tool.ts:301](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L301)
 
 还原转义后的 HTML
 
@@ -39004,7 +39001,7 @@ lib/tool/functions/urlAtom.md
 
 > **urlAtom**(`url`): `string`
 
-Defined in: [lib/tool.ts:477](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L477)
+Defined in: [lib/tool.ts:492](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L492)
 
 处理 URL 中的 .. / . 等
 
@@ -39031,7 +39028,7 @@ lib/tool/functions/urlResolve.md
 
 > **urlResolve**(`from`, `to`): `string`
 
-Defined in: [lib/tool.ts:472](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L472)
+Defined in: [lib/tool.ts:487](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L487)
 
 将相对路径根据基准路径进行转换
 
@@ -39066,7 +39063,7 @@ lib/tool/functions/weightFormat.md
 
 > **weightFormat**(`weight`, `spliter?`): `string`
 
-Defined in: [lib/tool.ts:89](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L89)
+Defined in: [lib/tool.ts:104](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L104)
 
 将毫克重量格式化为带单位的字符串
 
@@ -39106,6 +39103,7 @@ lib/tool/index.md
 ## Interfaces
 
 - [IClassPrototype](interfaces/IClassPrototype.md)
+- [ICompressorOptions](interfaces/ICompressorOptions.md)
 - [IDecodedText](interfaces/IDecodedText.md)
 - [IRequestOptions](interfaces/IRequestOptions.md)
 - [ITextEncoding](interfaces/ITextEncoding.md)
@@ -39211,7 +39209,7 @@ lib/tool/interfaces/IClassPrototype.md
 
 # Interface: IClassPrototype
 
-Defined in: [lib/tool.ts:47](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L47)
+Defined in: [lib/tool.ts:62](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L62)
 
 类原型信息
 
@@ -39221,7 +39219,7 @@ Defined in: [lib/tool.ts:47](https://github.com/maiyun/clickgo/blob/master/dist/
 
 > **access**: `Record`\<`string`, \{ `get`: `any`; `set`: `any`; \}\>
 
-Defined in: [lib/tool.ts:51](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L51)
+Defined in: [lib/tool.ts:66](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L66)
 
 访问器列表，key 为属性名，value 为包含 get 和 set 的对象，例如：{'prop1': { 'get': function() { ... }, 'set': function(v) { ... } }}
 
@@ -39231,10 +39229,75 @@ Defined in: [lib/tool.ts:51](https://github.com/maiyun/clickgo/blob/master/dist/
 
 > **method**: `Record`\<`string`, `any`\>
 
-Defined in: [lib/tool.ts:49](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L49)
+Defined in: [lib/tool.ts:64](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L64)
 
 方法列表，key 为方法名，value 为函数体，例如：{'method1': function() { ... }}
 
+lib/tool/interfaces/ICompressorOptions.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/tool](../index.md) / ICompressorOptions
+
+# Interface: ICompressorOptions
+
+Defined in: [lib/tool.ts:31](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L31)
+
+图片压缩参数，未指定大小上限时仅使用第一档质量
+
+## Properties
+
+### maxHeight?
+
+> `optional` **maxHeight?**: `number`
+
+Defined in: [lib/tool.ts:35](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L35)
+
+最高高度，默认无限
+
+***
+
+### maxSize?
+
+> `optional` **maxSize?**: `number`
+
+Defined in: [lib/tool.ts:41](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L41)
+
+文件大小上限，单位字节，须为正有限数；各档都超限时返回 false，不再额外缩小尺寸或降质
+
+***
+
+### maxWidth?
+
+> `optional` **maxWidth?**: `number`
+
+Defined in: [lib/tool.ts:33](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L33)
+
+最大宽度，默认无限
+
+***
+
+### mimeType?
+
+> `optional` **mimeType?**: `"auto"` \| `"image/jpeg"` \| `"image/png"` \| `"image/webp"`
+
+Defined in: [lib/tool.ts:39](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L39)
+
+输出格式，默认 auto 保留压缩器的自动选择；JPEG 的透明区域填白
+
+***
+
+### quality?
+
+> `optional` **quality?**: `number` \| readonly `number`[]
+
+Defined in: [lib/tool.ts:37](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L37)
+
+编码质量，取值 0 至 1，默认 0.8；数组按顺序尝试，仅 JPEG/WebP 支持调节质量
+
 lib/tool/interfaces/IDecodedText.md
 ---
 
@@ -39297,7 +39360,7 @@ lib/tool/interfaces/IRequestOptions.md
 
 # Interface: IRequestOptions
 
-Defined in: [lib/tool.ts:850](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L850)
+Defined in: [lib/tool.ts:865](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L865)
 
 请求选项
 
@@ -39307,7 +39370,7 @@ Defined in: [lib/tool.ts:850](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **body?**: `FormData`
 
-Defined in: [lib/tool.ts:853](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L853)
+Defined in: [lib/tool.ts:868](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L868)
 
 ***
 
@@ -39315,7 +39378,7 @@ Defined in: [lib/tool.ts:853](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **credentials?**: `boolean`
 
-Defined in: [lib/tool.ts:851](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L851)
+Defined in: [lib/tool.ts:866](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L866)
 
 ***
 
@@ -39323,7 +39386,7 @@ Defined in: [lib/tool.ts:851](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **end?**: () => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:862](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L862)
+Defined in: [lib/tool.ts:877](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L877)
 
 #### Returns
 
@@ -39335,7 +39398,7 @@ Defined in: [lib/tool.ts:862](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **error?**: () => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:865](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L865)
+Defined in: [lib/tool.ts:880](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L880)
 
 #### Returns
 
@@ -39347,7 +39410,7 @@ Defined in: [lib/tool.ts:865](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **headers?**: `HeadersInit`
 
-Defined in: [lib/tool.ts:856](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L856)
+Defined in: [lib/tool.ts:871](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L871)
 
 ***
 
@@ -39355,7 +39418,7 @@ Defined in: [lib/tool.ts:856](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **load?**: (`res`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:864](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L864)
+Defined in: [lib/tool.ts:879](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L879)
 
 #### Parameters
 
@@ -39373,7 +39436,7 @@ Defined in: [lib/tool.ts:864](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **method?**: `"GET"` \| `"POST"`
 
-Defined in: [lib/tool.ts:852](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L852)
+Defined in: [lib/tool.ts:867](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L867)
 
 ***
 
@@ -39381,7 +39444,7 @@ Defined in: [lib/tool.ts:852](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **progress?**: (`loaded`, `total`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:863](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L863)
+Defined in: [lib/tool.ts:878](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L878)
 
 #### Parameters
 
@@ -39403,7 +39466,7 @@ Defined in: [lib/tool.ts:863](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **responseType?**: `XMLHttpRequestResponseType`
 
-Defined in: [lib/tool.ts:855](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L855)
+Defined in: [lib/tool.ts:870](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L870)
 
 ***
 
@@ -39411,7 +39474,7 @@ Defined in: [lib/tool.ts:855](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **start?**: (`total`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:861](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L861)
+Defined in: [lib/tool.ts:876](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L876)
 
 #### Parameters
 
@@ -39429,7 +39492,7 @@ Defined in: [lib/tool.ts:861](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **timeout?**: `number`
 
-Defined in: [lib/tool.ts:854](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L854)
+Defined in: [lib/tool.ts:869](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L869)
 
 ***
 
@@ -39437,7 +39500,7 @@ Defined in: [lib/tool.ts:854](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **uploadEnd?**: () => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:860](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L860)
+Defined in: [lib/tool.ts:875](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L875)
 
 #### Returns
 
@@ -39449,7 +39512,7 @@ Defined in: [lib/tool.ts:860](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **uploadProgress?**: (`loaded`, `total`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:859](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L859)
+Defined in: [lib/tool.ts:874](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L874)
 
 #### Parameters
 
@@ -39471,7 +39534,7 @@ Defined in: [lib/tool.ts:859](https://github.com/maiyun/clickgo/blob/master/dist
 
 > `optional` **uploadStart?**: (`total`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [lib/tool.ts:858](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L858)
+Defined in: [lib/tool.ts:873](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L873)
 
 #### Parameters
 
@@ -39529,7 +39592,7 @@ lib/tool/interfaces/IUrl.md
 
 # Interface: IUrl
 
-Defined in: [lib/tool.ts:835](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L835)
+Defined in: [lib/tool.ts:850](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L850)
 
 网址对象
 
@@ -39539,7 +39602,7 @@ Defined in: [lib/tool.ts:835](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **auth**: `string` \| `null`
 
-Defined in: [lib/tool.ts:836](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L836)
+Defined in: [lib/tool.ts:851](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L851)
 
 ***
 
@@ -39547,7 +39610,7 @@ Defined in: [lib/tool.ts:836](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **hash**: `string` \| `null`
 
-Defined in: [lib/tool.ts:837](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L837)
+Defined in: [lib/tool.ts:852](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L852)
 
 ***
 
@@ -39555,7 +39618,7 @@ Defined in: [lib/tool.ts:837](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **host**: `string` \| `null`
 
-Defined in: [lib/tool.ts:838](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L838)
+Defined in: [lib/tool.ts:853](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L853)
 
 ***
 
@@ -39563,7 +39626,7 @@ Defined in: [lib/tool.ts:838](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **hostname**: `string` \| `null`
 
-Defined in: [lib/tool.ts:839](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L839)
+Defined in: [lib/tool.ts:854](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L854)
 
 ***
 
@@ -39571,7 +39634,7 @@ Defined in: [lib/tool.ts:839](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **pass**: `string` \| `null`
 
-Defined in: [lib/tool.ts:840](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L840)
+Defined in: [lib/tool.ts:855](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L855)
 
 ***
 
@@ -39579,7 +39642,7 @@ Defined in: [lib/tool.ts:840](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **path**: `string` \| `null`
 
-Defined in: [lib/tool.ts:841](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L841)
+Defined in: [lib/tool.ts:856](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L856)
 
 ***
 
@@ -39587,7 +39650,7 @@ Defined in: [lib/tool.ts:841](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **pathname**: `string`
 
-Defined in: [lib/tool.ts:842](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L842)
+Defined in: [lib/tool.ts:857](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L857)
 
 ***
 
@@ -39595,7 +39658,7 @@ Defined in: [lib/tool.ts:842](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **port**: `string` \| `null`
 
-Defined in: [lib/tool.ts:844](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L844)
+Defined in: [lib/tool.ts:859](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L859)
 
 ***
 
@@ -39603,7 +39666,7 @@ Defined in: [lib/tool.ts:844](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **protocol**: `string` \| `null`
 
-Defined in: [lib/tool.ts:843](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L843)
+Defined in: [lib/tool.ts:858](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L858)
 
 ***
 
@@ -39611,7 +39674,7 @@ Defined in: [lib/tool.ts:843](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **query**: `string` \| `null`
 
-Defined in: [lib/tool.ts:845](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L845)
+Defined in: [lib/tool.ts:860](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L860)
 
 ***
 
@@ -39619,7 +39682,7 @@ Defined in: [lib/tool.ts:845](https://github.com/maiyun/clickgo/blob/master/dist
 
 > **user**: `string` \| `null`
 
-Defined in: [lib/tool.ts:846](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L846)
+Defined in: [lib/tool.ts:861](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L861)
 
 lib/tool/type-aliases/TFalsy.md
 ---
@@ -39634,7 +39697,7 @@ lib/tool/type-aliases/TFalsy.md
 
 > **TFalsy** = `false` \| `""` \| `0` \| `null` \| `undefined` \| *typeof* `NaN`
 
-Defined in: [lib/tool.ts:872](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L872)
+Defined in: [lib/tool.ts:887](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L887)
 
 虚假值类型
 
@@ -39651,7 +39714,7 @@ lib/tool/type-aliases/TJson.md
 
 > **TJson** = `null` \| `boolean` \| `number` \| `string` \| `TJson`[] \| \{\[`key`: `string`\]: `TJson`; \}
 
-Defined in: [lib/tool.ts:869](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L869)
+Defined in: [lib/tool.ts:884](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L884)
 
 JSON 数据值，不包含 undefined、BigInt、函数和非有限数
 
@@ -39685,7 +39748,7 @@ lib/tool/variables/lang.md
 
 > `const` **lang**: `object`
 
-Defined in: [lib/tool.ts:735](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L735)
+Defined in: [lib/tool.ts:750](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L750)
 
 语言相关
 
@@ -39782,7 +39845,7 @@ lib/tool/variables/RANDOM_L.md
 
 > `const` **RANDOM\_L**: `"abcdefghijklmnopqrstuvwxyz"` = `'abcdefghijklmnopqrstuvwxyz'`
 
-Defined in: [lib/tool.ts:230](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L230)
+Defined in: [lib/tool.ts:245](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L245)
 
 lib/tool/variables/RANDOM_LN.md
 ---
@@ -39797,7 +39860,7 @@ lib/tool/variables/RANDOM_LN.md
 
 > `const` **RANDOM\_LN**: `string`
 
-Defined in: [lib/tool.ts:233](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L233)
+Defined in: [lib/tool.ts:248](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L248)
 
 lib/tool/variables/RANDOM_LU.md
 ---
@@ -39812,7 +39875,7 @@ lib/tool/variables/RANDOM_LU.md
 
 > `const` **RANDOM\_LU**: `string`
 
-Defined in: [lib/tool.ts:234](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L234)
+Defined in: [lib/tool.ts:249](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L249)
 
 lib/tool/variables/RANDOM_LUN.md
 ---
@@ -39827,7 +39890,7 @@ lib/tool/variables/RANDOM_LUN.md
 
 > `const` **RANDOM\_LUN**: `string`
 
-Defined in: [lib/tool.ts:235](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L235)
+Defined in: [lib/tool.ts:250](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L250)
 
 lib/tool/variables/RANDOM_LUNS.md
 ---
@@ -39842,7 +39905,7 @@ lib/tool/variables/RANDOM_LUNS.md
 
 > `const` **RANDOM\_LUNS**: `string`
 
-Defined in: [lib/tool.ts:237](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L237)
+Defined in: [lib/tool.ts:252](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L252)
 
 lib/tool/variables/RANDOM_N.md
 ---
@@ -39857,7 +39920,7 @@ lib/tool/variables/RANDOM_N.md
 
 > `const` **RANDOM\_N**: `"0123456789"` = `'0123456789'`
 
-Defined in: [lib/tool.ts:228](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L228)
+Defined in: [lib/tool.ts:243](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L243)
 
 lib/tool/variables/RANDOM_U.md
 ---
@@ -39872,7 +39935,7 @@ lib/tool/variables/RANDOM_U.md
 
 > `const` **RANDOM\_U**: `"ABCDEFGHIJKLMNOPQRSTUVWXYZ"` = `'ABCDEFGHIJKLMNOPQRSTUVWXYZ'`
 
-Defined in: [lib/tool.ts:229](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L229)
+Defined in: [lib/tool.ts:244](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L244)
 
 lib/tool/variables/RANDOM_UN.md
 ---
@@ -39887,7 +39950,7 @@ lib/tool/variables/RANDOM_UN.md
 
 > `const` **RANDOM\_UN**: `string`
 
-Defined in: [lib/tool.ts:232](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L232)
+Defined in: [lib/tool.ts:247](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L247)
 
 lib/tool/variables/RANDOM_V.md
 ---
@@ -39902,7 +39965,7 @@ lib/tool/variables/RANDOM_V.md
 
 > `const` **RANDOM\_V**: `"ACEFGHJKLMNPRSTWXY34567"` = `'ACEFGHJKLMNPRSTWXY34567'`
 
-Defined in: [lib/tool.ts:236](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L236)
+Defined in: [lib/tool.ts:251](https://github.com/maiyun/clickgo/blob/master/dist/lib/tool.ts#L251)
 
 lib/zip/classes/Zip.md
 ---