@maiyunnet/kebab 8.6.0 → 8.6.2

package/doc/kebab-rag.md

@@ -1410,7 +1410,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"8.6.0"` = `'8.6.0'`
+> `const` **VER**: `"8.6.2"` = `'8.6.2'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -10474,7 +10474,7 @@ lib/net/functions/buildCookieQuery.md
 
 > **buildCookieQuery**(`cookie`, `uri`): `string`
 
-Defined in: [lib/net.ts:628](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L628)
+Defined in: [lib/net.ts:637](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L637)
 
 对象转换为 Cookie 拼接字符串（会自动筛掉不能发送的 cookie）
 
@@ -10544,7 +10544,7 @@ lib/net/functions/filterHeaders.md
 
 > **filterHeaders**(`headers`, `res?`, `filter?`): `Record`\<`string`, `string` \| `string`[]\>
 
-Defined in: [lib/net.ts:706](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L706)
+Defined in: [lib/net.ts:715](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L715)
 
 剔除不代理的 header，返回新的 header
 
@@ -10641,7 +10641,7 @@ lib/net/functions/getFormData.md
 
 > **getFormData**(): [`FormData`](../formdata/classes/FormData.md)
 
-Defined in: [lib/net.ts:690](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L690)
+Defined in: [lib/net.ts:699](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L699)
 
 创建 FormData 对象
 
@@ -10662,7 +10662,7 @@ lib/net/functions/mproxy.md
 
 > **mproxy**(`ctr`, `auth`, `opt?`): `Promise`\<`number`\>
 
-Defined in: [lib/net.ts:742](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L742)
+Defined in: [lib/net.ts:751](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L751)
 
 正向 mproxy 代理，注意提前处理不要自动处理 post 数据，读取 get 的 url 为实际请求地址
 get: url, auth
@@ -10704,7 +10704,7 @@ lib/net/functions/mproxyData.md
 
 > **mproxyData**(`ctr`): `any`
 
-Defined in: [lib/net.ts:791](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L791)
+Defined in: [lib/net.ts:800](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L800)
 
 获取 mproxy 的附加数据
 
@@ -10922,7 +10922,7 @@ lib/net/functions/resetCookieSession.md
 
 > **resetCookieSession**(`cookie`): `void`
 
-Defined in: [lib/net.ts:678](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L678)
+Defined in: [lib/net.ts:687](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L687)
 
 模拟重启浏览器后的状态
 
@@ -10951,7 +10951,7 @@ lib/net/functions/rproxy.md
 
 > **rproxy**(`ctr`, `route`, `opt?`): `Promise`\<`boolean`\>
 
-Defined in: [lib/net.ts:809](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L809)
+Defined in: [lib/net.ts:818](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L818)
 
 反向代理，注意提前处理不要自动处理 post 数据，将本服务器的某个路由反代到其他网址
 
@@ -10992,7 +10992,7 @@ lib/net/functions/setCookie.md
 
 > **setCookie**(`cookie`, `name`, `value`, `domain`, `opt?`): `void`
 
-Defined in: [lib/net.ts:466](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L466)
+Defined in: [lib/net.ts:475](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L475)
 
 对 cookie 对象进行操作
 
@@ -11098,7 +11098,7 @@ lib/net/interfaces/ICookie.md
 
 # Interface: ICookie
 
-Defined in: [lib/net.ts:934](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L934)
+Defined in: [lib/net.ts:945](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L945)
 
 Net Cookie 对象
 
@@ -11108,7 +11108,7 @@ Net Cookie 对象
 
 > **domain**: `string`
 
-Defined in: [lib/net.ts:940](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L940)
+Defined in: [lib/net.ts:951](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L951)
 
 ***
 
@@ -11116,7 +11116,7 @@ Defined in: [lib/net.ts:940](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **exp**: `number`
 
-Defined in: [lib/net.ts:938](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L938)
+Defined in: [lib/net.ts:949](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L949)
 
 有效期秒级时间戳
 
@@ -11126,7 +11126,7 @@ Defined in: [lib/net.ts:938](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **httponly**: `boolean`
 
-Defined in: [lib/net.ts:942](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L942)
+Defined in: [lib/net.ts:953](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L953)
 
 ***
 
@@ -11134,7 +11134,7 @@ Defined in: [lib/net.ts:942](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **name**: `string`
 
-Defined in: [lib/net.ts:935](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L935)
+Defined in: [lib/net.ts:946](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L946)
 
 ***
 
@@ -11142,7 +11142,7 @@ Defined in: [lib/net.ts:935](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **path**: `string`
 
-Defined in: [lib/net.ts:939](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L939)
+Defined in: [lib/net.ts:950](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L950)
 
 ***
 
@@ -11150,7 +11150,7 @@ Defined in: [lib/net.ts:939](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **secure**: `boolean`
 
-Defined in: [lib/net.ts:941](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L941)
+Defined in: [lib/net.ts:952](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L952)
 
 ***
 
@@ -11158,7 +11158,7 @@ Defined in: [lib/net.ts:941](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > **value**: `string`
 
-Defined in: [lib/net.ts:936](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L936)
+Defined in: [lib/net.ts:947](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L947)
 
 lib/net/interfaces/IMproxyOptions.md
 ---
@@ -11171,7 +11171,7 @@ lib/net/interfaces/IMproxyOptions.md
 
 # Interface: IMproxyOptions
 
-Defined in: [lib/net.ts:889](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L889)
+Defined in: [lib/net.ts:900](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L900)
 
 正向代理请求的传入参数选项
 
@@ -11181,7 +11181,7 @@ Defined in: [lib/net.ts:889](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **filter**: (`h`) => `boolean`
 
-Defined in: [lib/net.ts:898](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L898)
+Defined in: [lib/net.ts:909](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L909)
 
 过滤 header，返回 true 则留下
 
@@ -11201,7 +11201,7 @@ Defined in: [lib/net.ts:898](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **follow**: `number`
 
-Defined in: [lib/net.ts:892](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L892)
+Defined in: [lib/net.ts:903](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L903)
 
 ***
 
@@ -11209,7 +11209,7 @@ Defined in: [lib/net.ts:892](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **headers**: [`THttpHeaders`](../type-aliases/THttpHeaders.md)
 
-Defined in: [lib/net.ts:896](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L896)
+Defined in: [lib/net.ts:907](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L907)
 
 ***
 
@@ -11217,7 +11217,7 @@ Defined in: [lib/net.ts:896](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **hosts**: `string` \| `Record`\<`string`, `string`\>
 
-Defined in: [lib/net.ts:894](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L894)
+Defined in: [lib/net.ts:905](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L905)
 
 自定义 host 映射，如 {'www.maiyun.net': '127.0.0.1'}，或全部映射到一个 host
 
@@ -11227,7 +11227,7 @@ Defined in: [lib/net.ts:894](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **local**: `string`
 
-Defined in: [lib/net.ts:895](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L895)
+Defined in: [lib/net.ts:906](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L906)
 
 ***
 
@@ -11235,7 +11235,7 @@ Defined in: [lib/net.ts:895](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **reuse**: `string`
 
-Defined in: [lib/net.ts:900](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L900)
+Defined in: [lib/net.ts:911](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L911)
 
 默认为 default
 
@@ -11245,7 +11245,7 @@ Defined in: [lib/net.ts:900](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **timeout**: `number`
 
-Defined in: [lib/net.ts:891](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L891)
+Defined in: [lib/net.ts:902](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L902)
 
 秒数
 
@@ -11260,7 +11260,7 @@ lib/net/interfaces/IRequestOptions.md
 
 # Interface: IRequestOptions
 
-Defined in: [lib/net.ts:862](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L862)
+Defined in: [lib/net.ts:871](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L871)
 
 请求的传入参数选项
 
@@ -11270,7 +11270,7 @@ Defined in: [lib/net.ts:862](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **cookie**: `Record`\<`string`, [`ICookie`](ICookie.md)\>
 
-Defined in: [lib/net.ts:885](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L885)
+Defined in: [lib/net.ts:894](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L894)
 
 cookie 托管对象
 
@@ -11280,7 +11280,7 @@ cookie 托管对象
 
 > `optional` **follow**: `number`
 
-Defined in: [lib/net.ts:868](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L868)
+Defined in: [lib/net.ts:877](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L877)
 
 追踪 location 次数，0 为不追踪，默认为 0
 
@@ -11290,7 +11290,7 @@ Defined in: [lib/net.ts:868](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **headers**: [`THttpHeaders`](../type-aliases/THttpHeaders.md)
 
-Defined in: [lib/net.ts:873](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L873)
+Defined in: [lib/net.ts:882](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L882)
 
 ***
 
@@ -11298,7 +11298,7 @@ Defined in: [lib/net.ts:873](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **hosts**: `string` \| `Record`\<`string`, `string`\>
 
-Defined in: [lib/net.ts:870](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L870)
+Defined in: [lib/net.ts:879](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L879)
 
 自定义 host 映射，如 {'www.maiyun.net': '127.0.0.1'}，或全部映射到一个 host
 
@@ -11308,7 +11308,7 @@ Defined in: [lib/net.ts:870](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **keep**: `boolean`
 
-Defined in: [lib/net.ts:881](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L881)
+Defined in: [lib/net.ts:890](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L890)
 
 连接是否保持长连接（即是否允许复用），默认为 true
 
@@ -11318,7 +11318,17 @@ Defined in: [lib/net.ts:881](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **local**: `string`
 
-Defined in: [lib/net.ts:872](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L872)
+Defined in: [lib/net.ts:881](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L881)
+
+***
+
+### log?
+
+> `optional` **log**: `boolean`
+
+Defined in: [lib/net.ts:896](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L896)
+
+若有异常写入文件日志，默认为 true
 
 ***
 
@@ -11326,7 +11336,7 @@ Defined in: [lib/net.ts:872](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **method**: `"GET"` \| `"POST"` \| `"PUT"` \| `"DELETE"` \| `"OPTIONS"`
 
-Defined in: [lib/net.ts:863](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L863)
+Defined in: [lib/net.ts:872](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L872)
 
 ***
 
@@ -11334,7 +11344,7 @@ Defined in: [lib/net.ts:863](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **mproxy**: `object`
 
-Defined in: [lib/net.ts:875](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L875)
+Defined in: [lib/net.ts:884](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L884)
 
 正向 mproxy 代理，url 如 https://xxx/abc
 
@@ -11356,7 +11366,7 @@ Defined in: [lib/net.ts:875](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **reuse**: `string`
 
-Defined in: [lib/net.ts:883](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L883)
+Defined in: [lib/net.ts:892](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L892)
 
 复用池名，默认为 default
 
@@ -11366,7 +11376,7 @@ Defined in: [lib/net.ts:883](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **save**: `string`
 
-Defined in: [lib/net.ts:871](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L871)
+Defined in: [lib/net.ts:880](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L880)
 
 ***
 
@@ -11374,7 +11384,7 @@ Defined in: [lib/net.ts:871](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **timeout**: `number`
 
-Defined in: [lib/net.ts:866](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L866)
+Defined in: [lib/net.ts:875](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L875)
 
 秒数
 
@@ -11384,7 +11394,7 @@ Defined in: [lib/net.ts:866](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **type**: `"form"` \| `"json"`
 
-Defined in: [lib/net.ts:864](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L864)
+Defined in: [lib/net.ts:873](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L873)
 
 lib/net/interfaces/IRproxyOptions.md
 ---
@@ -11397,7 +11407,7 @@ lib/net/interfaces/IRproxyOptions.md
 
 # Interface: IRproxyOptions
 
-Defined in: [lib/net.ts:904](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L904)
+Defined in: [lib/net.ts:915](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L915)
 
 反向代理请求的传入参数选项
 
@@ -11407,7 +11417,7 @@ Defined in: [lib/net.ts:904](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **filter**: (`h`) => `boolean`
 
-Defined in: [lib/net.ts:913](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L913)
+Defined in: [lib/net.ts:924](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L924)
 
 过滤 header，返回 true 则留下
 
@@ -11427,7 +11437,7 @@ Defined in: [lib/net.ts:913](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **follow**: `number`
 
-Defined in: [lib/net.ts:907](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L907)
+Defined in: [lib/net.ts:918](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L918)
 
 ***
 
@@ -11435,7 +11445,7 @@ Defined in: [lib/net.ts:907](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **headers**: [`THttpHeaders`](../type-aliases/THttpHeaders.md)
 
-Defined in: [lib/net.ts:911](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L911)
+Defined in: [lib/net.ts:922](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L922)
 
 ***
 
@@ -11443,7 +11453,7 @@ Defined in: [lib/net.ts:911](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **hosts**: `string` \| `Record`\<`string`, `string`\>
 
-Defined in: [lib/net.ts:909](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L909)
+Defined in: [lib/net.ts:920](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L920)
 
 自定义 host 映射，如 {'www.maiyun.net': '127.0.0.1'}，或全部映射到一个 host
 
@@ -11453,7 +11463,7 @@ Defined in: [lib/net.ts:909](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **local**: `string`
 
-Defined in: [lib/net.ts:910](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L910)
+Defined in: [lib/net.ts:921](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L921)
 
 ***
 
@@ -11461,7 +11471,7 @@ Defined in: [lib/net.ts:910](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **mproxy**: `object`
 
-Defined in: [lib/net.ts:915](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L915)
+Defined in: [lib/net.ts:926](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L926)
 
 正向 mproxy 代理，url 如 https://xxx/abc
 
@@ -11483,7 +11493,7 @@ Defined in: [lib/net.ts:915](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **reuse**: `string`
 
-Defined in: [lib/net.ts:921](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L921)
+Defined in: [lib/net.ts:932](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L932)
 
 默认为 default
 
@@ -11493,7 +11503,7 @@ Defined in: [lib/net.ts:921](https://github.com/maiyunnet/kebab/blob/master/lib/
 
 > `optional` **timeout**: `number`
 
-Defined in: [lib/net.ts:906](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L906)
+Defined in: [lib/net.ts:917](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L917)
 
 秒数
 
@@ -11954,7 +11964,7 @@ lib/net/type-aliases/THttpHeaders.md
 
 > **THttpHeaders** = `http.IncomingHttpHeaders` & `object`
 
-Defined in: [lib/net.ts:926](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L926)
+Defined in: [lib/net.ts:937](https://github.com/maiyunnet/kebab/blob/master/lib/net.ts#L937)
 
 http headers
 
@@ -20059,7 +20069,7 @@ Defined in: [sys/ctr.ts:548](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_cross**(): `boolean`
 
-Defined in: [sys/ctr.ts:762](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L762)
+Defined in: [sys/ctr.ts:765](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L765)
 
 开启跨域请求
 返回 true 接续执行，返回 false 需要中断用户本次访问（options请求）
@@ -20074,7 +20084,7 @@ Defined in: [sys/ctr.ts:762](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_device**(): `"unknown"` \| `"android"` \| `"linux"` \| `"windows"` \| `"macintosh"` \| `"ipad"`
 
-Defined in: [sys/ctr.ts:587](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L587)
+Defined in: [sys/ctr.ts:590](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L590)
 
 根据用户 ua 获取当前用户的设备类型
 
@@ -20086,13 +20096,21 @@ Defined in: [sys/ctr.ts:587](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 ### \_enabledXsrf()
 
-> `protected` **\_enabledXsrf**(): `void`
+> `protected` **\_enabledXsrf**(`opt?`): `void`
 
 Defined in: [sys/ctr.ts:559](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L559)
 
 当前页面开启 XSRF 支持（主要检测 cookie 是否存在）
 如果当前页面有 CDN，请不要使用
 
+#### Parameters
+
+##### opt?
+
+###### domain?
+
+`string`
+
 #### Returns
 
 `void`
@@ -20103,7 +20121,7 @@ Defined in: [sys/ctr.ts:559](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_end**(): `void`
 
-Defined in: [sys/ctr.ts:845](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L845)
+Defined in: [sys/ctr.ts:848](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L848)
 
 主动关闭当前 socket 连接
 
@@ -20117,7 +20135,7 @@ Defined in: [sys/ctr.ts:845](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_getBasicAuth**(`user`, `pwd`): `string`
 
-Defined in: [sys/ctr.ts:580](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L580)
+Defined in: [sys/ctr.ts:583](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L583)
 
 获取 Auth 字符串，用于客户端提交
 
@@ -20145,7 +20163,7 @@ Defined in: [sys/ctr.ts:580](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_getLocale**(): `string`
 
-Defined in: [sys/ctr.ts:754](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L754)
+Defined in: [sys/ctr.ts:757](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L757)
 
 获取当前语言名
 
@@ -20159,7 +20177,7 @@ Defined in: [sys/ctr.ts:754](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_getLocaleJsonString**(): `string`
 
-Defined in: [sys/ctr.ts:742](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L742)
+Defined in: [sys/ctr.ts:745](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L745)
 
 根据当前后台语言包设置情况获取 JSON 字符串传输到前台
 
@@ -20211,7 +20229,7 @@ Defined in: [sys/ctr.ts:315](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_handleFormData**(`events?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/ctr.ts:853](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L853)
+Defined in: [sys/ctr.ts:856](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L856)
 
 获取 formdata 的信息
 
@@ -20243,7 +20261,7 @@ Defined in: [sys/ctr.ts:853](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **\_l**(`key`, `data?`): `string`
 
-Defined in: [sys/ctr.ts:780](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L780)
+Defined in: [sys/ctr.ts:783](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L783)
 
 获取语言包值
 
@@ -20269,7 +20287,7 @@ Defined in: [sys/ctr.ts:780](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_loadData**(`path`): `Promise`\<`Record`\<`string`, `string`\> \| `null`\>
 
-Defined in: [sys/ctr.ts:645](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L645)
+Defined in: [sys/ctr.ts:648](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L648)
 
 获取 data 数据
 
@@ -20291,7 +20309,7 @@ Defined in: [sys/ctr.ts:645](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_loadLocale**(`loc`, `pkg?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/ctr.ts:693](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L693)
+Defined in: [sys/ctr.ts:696](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L696)
 
 设定语言并加载语言包
 
@@ -20343,7 +20361,7 @@ Defined in: [sys/ctr.ts:332](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_location**(`location`): `false`
 
-Defined in: [sys/ctr.ts:663](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L663)
+Defined in: [sys/ctr.ts:666](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L666)
 
 跳转（302临时跳转），支持相对本项目根路径的路径或绝对路径
 
@@ -20365,7 +20383,7 @@ Defined in: [sys/ctr.ts:663](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_ping**(`data?`): `boolean`
 
-Defined in: [sys/ctr.ts:830](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L830)
+Defined in: [sys/ctr.ts:833](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L833)
 
 发送 socket ping
 
@@ -20387,7 +20405,7 @@ Defined in: [sys/ctr.ts:830](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_pong**(`data?`): `boolean`
 
-Defined in: [sys/ctr.ts:838](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L838)
+Defined in: [sys/ctr.ts:841](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L841)
 
 发送 socket pong
 
@@ -20409,7 +20427,7 @@ Defined in: [sys/ctr.ts:838](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_startSession**(`link`, `auth?`, `opt?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/ctr.ts:677](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L677)
+Defined in: [sys/ctr.ts:680](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L680)
 
 开启 Session
 
@@ -20443,7 +20461,7 @@ Kv 或 Db 实例
 
 > `protected` **\_writeBinary**(`data`): `boolean`
 
-Defined in: [sys/ctr.ts:822](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L822)
+Defined in: [sys/ctr.ts:825](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L825)
 
 发送 socket 二进制
 
@@ -20465,7 +20483,7 @@ Defined in: [sys/ctr.ts:822](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_writeResult**(`data`): `boolean`
 
-Defined in: [sys/ctr.ts:814](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L814)
+Defined in: [sys/ctr.ts:817](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L817)
 
 发送结果对象文本
 
@@ -20487,7 +20505,7 @@ Defined in: [sys/ctr.ts:814](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_writeText**(`data`): `boolean`
 
-Defined in: [sys/ctr.ts:806](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L806)
+Defined in: [sys/ctr.ts:809](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L809)
 
 发送 socket 文本
 
@@ -20509,7 +20527,7 @@ Defined in: [sys/ctr.ts:806](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > **getAuthorization**(): `string` \| `false` \| \{ `pwd`: `string`; `user`: `string`; \}
 
-Defined in: [sys/ctr.ts:608](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L608)
+Defined in: [sys/ctr.ts:611](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L611)
 
 通过 header 或 _auth 获取鉴权信息或 JWT 信息（不解析）
 

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "8.6.0";
+export declare const VER = "8.6.2";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 /** --- 框架的 LIB，以 / 结尾 --- */

package/index.js

@@ -6,7 +6,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export const VER = '8.6.0';
+export const VER = '8.6.2';
 // --- 服务端用的路径 ---
 const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */

package/lib/net.d.ts

@@ -148,6 +148,8 @@ export interface IRequestOptions {
     'reuse'?: string;
     /** --- cookie 托管对象 --- */
     'cookie'?: Record<string, ICookie>;
+    /** --- 若有异常写入文件日志，默认为 true --- */
+    'log'?: boolean;
 }
 /** --- 正向代理请求的传入参数选项 --- */
 export interface IMproxyOptions {

package/lib/net.js

@@ -303,6 +303,9 @@ export async function request(u, data, opt = {}) {
                 'name': 'Possible mProxy error',
                 'message': 'hostname not found',
             };
+            if (opt.log === undefined || opt.log) {
+                lCore.log({}, `[NET][REQUEST] ${res.error.message}`, '-neterror');
+            }
             return res;
         }
         if (typeof hosts === 'string' ?
@@ -313,6 +316,9 @@ export async function request(u, data, opt = {}) {
                 'name': 'hosts error',
                 'message': 'hosts param error',
             };
+            if (opt.log === undefined || opt.log) {
+                lCore.log({}, `[NET][REQUEST] ${res.error.message}`, '-neterror');
+            }
             return res;
         }
         reuses[reuse] ??= hc.createHttpClient();
@@ -333,6 +339,9 @@ export async function request(u, data, opt = {}) {
     catch (err) {
         const res = new lResponse.Response(null);
         res.error = err;
+        if (opt.log === undefined || opt.log) {
+            lCore.log({}, `[NET][REQUEST] ${err.message}`, '-neterror');
+        }
         return res;
     }
     // --- 处理返回值 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "8.6.0",
+  "version": "8.6.2",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [

package/sys/ctr.d.ts

@@ -179,7 +179,9 @@ export declare class Ctr {
      * --- 当前页面开启 XSRF 支持（主要检测 cookie 是否存在） ---
      * --- 如果当前页面有 CDN，请不要使用 ---
      */
-    protected _enabledXsrf(): void;
+    protected _enabledXsrf(opt?: {
+        'domain'?: string;
+    }): void;
     /**
      * --- 获取 Auth 字符串，用于客户端提交 ---
      * @param user 用户名

package/sys/ctr.js

@@ -440,14 +440,15 @@ export class Ctr {
      * --- 当前页面开启 XSRF 支持（主要检测 cookie 是否存在） ---
      * --- 如果当前页面有 CDN，请不要使用 ---
      */
-    _enabledXsrf() {
+    _enabledXsrf(opt) {
         // --- 设置 XSRF 值 ---
         if (this._cookie['XSRF-TOKEN'] === undefined) {
             const xsrf = lCore.random(16, lCore.RANDOM_LUN);
             this._xsrf = xsrf;
             lCore.setCookie(this, 'XSRF-TOKEN', xsrf, {
                 'path': '/',
-                'httponly': true
+                'httponly': true,
+                'domain': opt?.domain,
             });
             this._cookie['XSRF-TOKEN'] = xsrf;
         }