@maiyunnet/kebab 3.2.18 → 3.2.20

package/index.d.ts

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

package/index.js

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

package/lib/core.d.ts

@@ -242,3 +242,10 @@ export declare function debug(message?: any, ...optionalParams: any[]): void;
  * @param optionalParams 参数
  */
 export declare function display(message?: any, ...optionalParams: any[]): void;
+/**
+ * --- 让 res 发送头部（前提是头部没有被发送才能调用本方法 ---
+ * @param res 响应对象
+ * @param statusCode 状态码
+ * @param headers 头部
+ */
+export declare function writeHead(res: http2.Http2ServerResponse | http.ServerResponse, statusCode: number, headers?: http.OutgoingHttpHeaders): void;

package/lib/core.js

@@ -4,6 +4,7 @@
  * Last: 2020-4-11 22:34:58, 2022-10-2 14:13:06, 2022-12-28 20:33:24, 2023-12-15 11:49:02, 2024-7-2 15:23:35, 2025-6-13 19:45:53
  */
 import * as cp from 'child_process';
+import * as http2 from 'http2';
 import * as stream from 'stream';
 import * as os from 'os';
 import * as kebab from '#kebab/index.js';
@@ -791,3 +792,17 @@ export function display(message, ...optionalParams) {
     // eslint-disable-next-line no-console
     console.log(message, ...optionalParams);
 }
+/**
+ * --- 让 res 发送头部（前提是头部没有被发送才能调用本方法 ---
+ * @param res 响应对象
+ * @param statusCode 状态码
+ * @param headers 头部
+ */
+export function writeHead(res, statusCode, headers) {
+    if (res instanceof http2.Http2ServerResponse) {
+        res.writeHead(statusCode, headers);
+    }
+    else {
+        res.writeHead(statusCode, headers);
+    }
+}

package/lib/cron.d.ts

@@ -14,7 +14,7 @@ export declare function run(): void;
 export interface IRegular {
     /** --- 任务名称 --- */
     'name': string;
-    /** --- 任务对象 --- */
+    /** --- 任务日期对象（系统时区） --- */
     'date': {
         /** --- -1, 1 - 12 --- */
         'month': number;
@@ -31,7 +31,7 @@ export interface IRegular {
     callback: (date: string) => void | Promise<void>;
 }
 export interface IRegularData extends IRegular {
-    /** --- 上次执行时间字符串 --- */
+    /** --- 上次执行时间字符串，格式：YmdHi（系统时区） --- */
     'last': string;
     /** --- 总执行次数 --- */
     'count': number;

package/lib/fs.js

@@ -424,19 +424,18 @@ export function createWriteStream(path, options) {
  * @param stat 文件的 stat（如果有）
  */
 export async function readToResponse(path, req, res, stat) {
-    res.statusCode = 200;
     stat ??= await stats(path);
     if (!stat) {
         const content = '<h1>404 Not found</h1><hr>Kebab';
-        res.statusCode = 404;
         res.setHeader('content-length', Buffer.byteLength(content));
+        lCore.writeHead(res, 404);
         res.end(content);
         return;
     }
     // --- 判断缓存以及 MIME 和编码 ---
     let charset = '';
     const mimeData = mime.getData(path);
-    if (['htm', 'html', 'css', 'js', 'xml', 'jpg', 'jpeg', 'svg', 'gif', 'png'].includes(mimeData.extension)) {
+    if (['htm', 'html', 'css', 'js', 'xml', 'jpg', 'jpeg', 'svg', 'gif', 'png', 'json'].includes(mimeData.extension)) {
         charset = '; charset=utf-8';
         // --- 这些文件可能需要缓存 ---
         const hash = `W/"${stat.size.toString(16)}-${stat.mtime.getTime().toString(16)}"`;
@@ -447,7 +446,7 @@ export async function readToResponse(path, req, res, stat) {
         const noneMatch = req.headers['if-none-match'];
         const modifiedSince = req.headers['if-modified-since'];
         if ((hash === noneMatch) && (lastModified === modifiedSince)) {
-            res.statusCode = 304;
+            lCore.writeHead(res, 304);
             res.end();
             return;
         }
@@ -472,5 +471,6 @@ export async function readToResponse(path, req, res, stat) {
     }
     // --- 不压缩 ---
     res.setHeader('content-length', stat.size);
+    lCore.writeHead(res, 200);
     await pipe(path, res instanceof http2.Http2ServerResponse ? (res.stream ?? res) : res);
 }

package/lib/net.d.ts

@@ -114,6 +114,7 @@ export interface IRequestOptions {
     'type'?: 'form' | 'json';
     /** --- 秒数 --- */
     'timeout'?: number;
+    /** --- 追踪 location 次数，0 为不追踪，默认为 0 --- */
     'follow'?: number;
     /** --- 自定义 host 映射，如 {'www.maiyun.net': '127.0.0.1'}，或全部映射到一个 host --- */
     'hosts'?: Record<string, string> | string;

package/lib/net.js

@@ -12,6 +12,7 @@ import * as kebab from '#kebab/index.js';
 import * as lFs from '#kebab/lib/fs.js';
 import * as lText from '#kebab/lib/text.js';
 import * as lTime from '#kebab/lib/time.js';
+import * as lCore from './core.js';
 // --- 自己 ---
 import * as fd from './net/formdata.js';
 import * as lRequest from './net/request.js';
@@ -98,6 +99,7 @@ export async function request(u, data, opt = {}) {
     const method = opt.method ?? 'GET';
     const type = opt.type ?? 'form';
     const timeout = opt.timeout ?? 10;
+    /** --- 追踪 location 次数，0 为不追踪，默认为 0 --- */
     const follow = opt.follow ?? 0;
     const hosts = opt.hosts ?? {};
     const save = opt.save;
@@ -525,7 +527,7 @@ export async function mproxy(ctr, auth, opt = {}) {
     if (rres.headers) {
         filterHeaders(rres.headers, res, opt.filter);
     }
-    res.statusCode = rres.headers?.['http-code'] ?? 200;
+    lCore.writeHead(res, rres.headers?.['http-code'] ?? 200);
     await new Promise((resolve) => {
         stream.pipe(res).on('finish', () => {
             resolve();
@@ -589,7 +591,7 @@ export async function rproxy(ctr, route, opt = {}) {
         if (rres.headers) {
             filterHeaders(rres.headers, res, opt.filter);
         }
-        res.statusCode = rres.headers?.['http-code'] ?? 200;
+        lCore.writeHead(res, rres.headers?.['http-code'] ?? 200);
         await new Promise((resolve) => {
             stream.pipe(res).on('finish', () => {
                 resolve();

package/lib/text.d.ts

@@ -51,6 +51,7 @@ export declare const REGEXP_DOMAIN: RegExp;
  * @return bool
  */
 export declare function isDomain(domain: string): boolean;
+/** --- 可打印的 ascii 字符集 --- */
 export declare const REGEXP_ASCII: RegExp;
 /**
  * --- 判断是否在 ascii 字符集内，仅可输入部分 ---

package/lib/text.js

@@ -210,6 +210,7 @@ export const REGEXP_DOMAIN = /^.+?\.((?![0-9]).)+$/i;
 export function isDomain(domain) {
     return REGEXP_DOMAIN.test(domain);
 }
+/** --- 可打印的 ascii 字符集 --- */
 export const REGEXP_ASCII = /^[\x20-\x7E]*$/;
 /**
  * --- 判断是否在 ascii 字符集内，仅可输入部分 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "3.2.18",
+  "version": "3.2.20",
   "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/child.js

@@ -89,7 +89,7 @@ async function run() {
     }, function (req, res) {
         const host = (req.headers[':authority'] ?? req.headers['host'] ?? '');
         if (!host) {
-            res.statusCode = 403;
+            lCore.writeHead(res, 403);
             res.end();
             return;
         }
@@ -141,7 +141,7 @@ async function run() {
     httpServer = http.createServer(function (req, res) {
         const host = (req.headers['host'] ?? '');
         if (!host) {
-            res.statusCode = 403;
+            lCore.writeHead(res, 403);
             res.end();
             return;
         }
@@ -202,6 +202,7 @@ async function requestHandler(req, res, https) {
         'timeout': 30_000,
         'callback': () => {
             if (!req.socket.writable) {
+                // --- 用户连接已中断 ---
                 return;
             }
             if (res.headersSent) {
@@ -209,8 +210,8 @@ async function requestHandler(req, res, https) {
                 return;
             }
             const content = '<h1>504 Gateway Timeout</h1><hr>Kebab';
-            res.statusCode = 504;
             res.setHeader('content-length', Buffer.byteLength(content));
+            lCore.writeHead(res, 504);
             res.end(content);
         }
     };
@@ -232,7 +233,7 @@ async function requestHandler(req, res, https) {
     /** --- 当前的 vhost 配置文件 --- */
     const vhost = await getVhostByHostname(uri.hostname ?? '');
     if (!vhost) {
-        res.statusCode = 403;
+        lCore.writeHead(res, 403);
         res.end();
         return;
         /*
@@ -262,9 +263,9 @@ async function requestHandler(req, res, https) {
             let stat = await lFs.stats(vhost.real + now + item);
             if (!stat) {
                 const content = '<h1>404 Not found</h1><hr>Kebab';
-                res.statusCode = 404;
                 res.setHeader('content-type', 'text/html; charset=utf-8');
                 res.setHeader('content-length', Buffer.byteLength(content));
+                lCore.writeHead(res, 404);
                 res.end(content);
                 return;
             }
@@ -298,9 +299,11 @@ async function requestHandler(req, res, https) {
                             'headers': {}
                         }, '[CHILD][requestHandler][E0]' + lText.stringifyJson(e.stack).slice(1, -1), '-error');
                         const content = '<h1>500 Server Error</h1><hr>Kebab';
-                        res.statusCode = 500;
-                        res.setHeader('content-type', 'text/html; charset=utf-8');
-                        res.setHeader('content-length', Buffer.byteLength(content));
+                        if (!res.headersSent) {
+                            res.setHeader('content-type', 'text/html; charset=utf-8');
+                            res.setHeader('content-length', Buffer.byteLength(content));
+                            lCore.writeHead(res, 500);
+                        }
                         res.end(content);
                         return;
                     }
@@ -337,9 +340,11 @@ async function requestHandler(req, res, https) {
                 catch (e) {
                     lCore.log({}, '[CHILD][requestHandler][E1]' + lText.stringifyJson(e.stack).slice(1, -1), '-error');
                     const content = '<h1>500 Server Error</h1><hr>Kebab';
-                    res.statusCode = 500;
-                    res.setHeader('content-type', 'text/html; charset=utf-8');
-                    res.setHeader('content-length', Buffer.byteLength(content));
+                    if (!res.headersSent) {
+                        res.setHeader('content-type', 'text/html; charset=utf-8');
+                        res.setHeader('content-length', Buffer.byteLength(content));
+                        lCore.writeHead(res, 500);
+                    }
                     res.end(content);
                     return;
                 }
@@ -356,9 +361,9 @@ async function requestHandler(req, res, https) {
         }
     }
     const content = '<h1>403 Forbidden</h1><hr>Kebab';
-    res.statusCode = 403;
     res.setHeader('content-type', 'text/html; charset=utf-8');
     res.setHeader('content-length', Buffer.byteLength(content));
+    lCore.writeHead(res, 403);
     res.end(content);
 }
 /**

package/sys/cmd.js

@@ -126,16 +126,16 @@ async function run() {
         // --- config - s3 ---
         config.s3 ??= {};
         config.s3['CF'] ??= {};
-        config.s3['CF'].account = '';
-        config.s3['CF'].sid = '';
-        config.s3['CF'].skey = '';
-        config.s3['CF'].region = 'auto';
-        config.s3['CF'].bucket = '';
+        config.s3['CF'].account ??= '';
+        config.s3['CF'].sid ??= '';
+        config.s3['CF'].skey ??= '';
+        config.s3['CF'].region ??= 'auto';
+        config.s3['CF'].bucket ??= '';
         config.s3['TENCENT'] ??= {};
-        config.s3['TENCENT'].sid = '';
-        config.s3['TENCENT'].skey = '';
-        config.s3['TENCENT'].region = '';
-        config.s3['TENCENT'].bucket = '';
+        config.s3['TENCENT'].sid ??= '';
+        config.s3['TENCENT'].skey ??= '';
+        config.s3['TENCENT'].region ??= '';
+        config.s3['TENCENT'].bucket ??= '';
         // --- config - turnstile ---
         config.turnstile ??= {};
         config.turnstile['CF'] ??= {};

package/sys/ctr.d.ts

@@ -155,14 +155,14 @@ export declare class Ctr {
     /**
      * --- 检测提交的数据类型 ---
      * @param input 要校验的输入项
-     * @param rule 规则
+     * @param rule 规则, int, double, num(可字符串), array, bool, string, ascii
      * @param rtn 返回值
      */
     protected _checkInput(input: Record<string, kebab.Json>, rule: Record<string, kebab.Json[]>, rtn: kebab.Json[]): boolean;
     /**
      * --- 检测提交的数据类型（会检测 XSRF） ---
      * @param input 要校验的输入项
-     * @param rule 规则
+     * @param rule 规则, int, double, num(可字符串), array, bool, string, ascii
      * @param rtn 返回值
      */
     protected _checkXInput(input: Record<string, kebab.Json>, rule: Record<string, kebab.Json[]>, rtn: kebab.Json[]): boolean;

package/sys/ctr.js

@@ -218,7 +218,7 @@ export class Ctr {
     /**
      * --- 检测提交的数据类型 ---
      * @param input 要校验的输入项
-     * @param rule 规则
+     * @param rule 规则, int, double, num(可字符串), array, bool, string, ascii
      * @param rtn 返回值
      */
     _checkInput(input, rule, rtn) {
@@ -308,7 +308,8 @@ export class Ctr {
                         }
                         case 'int':
                         case 'integer': {
-                            if (input[key] && (typeof input[key] !== 'number') && !Number.isSafeInteger(input[key])) {
+                            // --- 必须是数字型且是整数 ---
+                            if (input[key] && !Number.isSafeInteger(input[key])) {
                                 rtn[0] = val[lastK][0];
                                 rtn[1] = val[lastK][1];
                                 if (val[lastK][2]) {
@@ -320,6 +321,7 @@ export class Ctr {
                         }
                         case 'float':
                         case 'double': {
+                            // --- 必须是数字型 ---
                             if (input[key] && (typeof input[key] !== 'number')) {
                                 rtn[0] = val[lastK][0];
                                 rtn[1] = val[lastK][1];
@@ -332,6 +334,7 @@ export class Ctr {
                         }
                         case 'num':
                         case 'number': {
+                            // --- 可字符串数字 ---
                             if (input[key] && (typeof input[key] !== 'number') && !/^[0-9]+\.?[0-9]*$/.test(input[key])) {
                                 rtn[0] = val[lastK][0];
                                 rtn[1] = val[lastK][1];
@@ -378,6 +381,18 @@ export class Ctr {
                             }
                             break;
                         }
+                        case 'ascii': {
+                            // --- 必须是 ASCII 字符 ---
+                            if (input[key] !== null && !lText.isAscii(input[key])) {
+                                rtn[0] = val[lastK][0];
+                                rtn[1] = val[lastK][1];
+                                if (val[lastK][2]) {
+                                    rtn[2] = val[lastK][2];
+                                }
+                                return false;
+                            }
+                            break;
+                        }
                         default: {
                             let match;
                             if (input[key] !== null) {
@@ -468,7 +483,7 @@ export class Ctr {
     /**
      * --- 检测提交的数据类型（会检测 XSRF） ---
      * @param input 要校验的输入项
-     * @param rule 规则
+     * @param rule 规则, int, double, num(可字符串), array, bool, string, ascii
      * @param rtn 返回值
      */
     _checkXInput(input, rule, rtn) {
@@ -669,6 +684,7 @@ export class Ctr {
         this._res.setHeader('access-control-allow-methods', '*');
         if (this._req.method === 'OPTIONS') {
             this._res.setHeader('access-control-max-age', '3600');
+            this._httpCode = 204;
             return false;
         }
         return true;

package/sys/mod.d.ts

@@ -69,6 +69,7 @@ export default class Mod {
     constructor(opt: {
         'db': lDb.Pool | lDb.Transaction;
         'ctr'?: sCtr.Ctr;
+        /** --- 框架会自动去重 --- */
         'index'?: string | string[];
         'alias'?: string;
         'row'?: Record<string, any>;

package/sys/route.js

@@ -37,9 +37,9 @@ export async function run(data) {
         if (!configContent) {
             if (data.res) {
                 const content = '<h1>500 File kebab.json can not be read</h1><hr>Kebab';
-                data.res.statusCode = 500;
                 data.res.setHeader('content-type', 'text/html; charset=utf-8');
                 data.res.setHeader('content-length', Buffer.byteLength(content));
+                lCore.writeHead(data.res, 500);
                 data.res.end(content);
             }
             else {
@@ -133,13 +133,13 @@ export async function run(data) {
                 /** --- 组合要跳转的路径 --- */
                 const apath = config.const.path + (config.const.qs ? '?' + config.const.qs : '');
                 if (config.lang.list.includes(lang)) {
-                    data.res.statusCode = 302;
                     data.res.setHeader('location', config.const.urlBase + lang + '/' + apath);
+                    lCore.writeHead(data.res, 302);
                     data.res.end('');
                     return true;
                 }
-                data.res.statusCode = 302;
                 data.res.setHeader('location', config.const.urlBase + config.lang.list[0] + '/' + apath);
+                lCore.writeHead(data.res, 302);
                 data.res.end('');
                 return true;
             }
@@ -183,15 +183,15 @@ export async function run(data) {
     if (pathLeft.startsWith('middle')) {
         if (data.res) {
             if (config.route['#404']) {
-                data.res.statusCode = 302;
                 data.res.setHeader('location', lText.urlResolve(config.const.urlBase, config.route['#404']));
+                lCore.writeHead(data.res, 302);
                 data.res.end('');
                 return true;
             }
             const content = '[Error] Controller not found, path: ' + path + '.';
-            data.res.statusCode = 404;
             data.res.setHeader('content-type', 'text/html; charset=utf-8');
             data.res.setHeader('content-length', Buffer.byteLength(content));
+            lCore.writeHead(data.res, 404);
             data.res.end(content);
         }
         else {
@@ -413,9 +413,9 @@ export async function run(data) {
     catch (e) {
         lCore.log(middle, '(E03)' + lText.stringifyJson(e.stack).slice(1, -1), '-error');
         const content = '<h1>500 Server Error</h1><hr>Kebab';
-        data.res.statusCode = 500;
         data.res.setHeader('content-type', 'text/html; charset=utf-8');
         data.res.setHeader('content-length', Buffer.byteLength(content));
+        lCore.writeHead(data.res, 500);
         data.res.end(content);
         return true;
     }
@@ -429,9 +429,9 @@ export async function run(data) {
         catch (e) {
             lCore.log(middle, '(E05)' + lText.stringifyJson(e.stack).slice(1, -1), '-error');
             const content = '<h1>500 Server Error</h1><hr>Kebab';
-            data.res.statusCode = 500;
             data.res.setHeader('content-type', 'text/html; charset=utf-8');
             data.res.setHeader('content-length', Buffer.byteLength(content));
+            lCore.writeHead(data.res, 500);
             data.res.end(content);
             return true;
         }
@@ -443,15 +443,15 @@ export async function run(data) {
             if (!await lFs.isFile(filePath)) {
                 // --- 指定的控制器不存在 ---
                 if (config.route['#404']) {
-                    data.res.statusCode = 302;
                     data.res.setHeader('location', lText.urlResolve(config.const.urlBase, config.route['#404']));
+                    lCore.writeHead(data.res, 302);
                     data.res.end('');
                     return true;
                 }
                 const content = '[Error] Controller not found, path: ' + path + '.';
-                data.res.statusCode = 404;
                 data.res.setHeader('content-type', 'text/html; charset=utf-8');
                 data.res.setHeader('content-length', Buffer.byteLength(content));
+                lCore.writeHead(data.res, 404);
                 data.res.end(content);
                 return true;
             }
@@ -482,8 +482,8 @@ export async function run(data) {
             lCore.log(cctr, '', '-visit');
             // --- 强制 HTTPS ---
             if (config.set.mustHttps && !config.const.https) {
-                data.res.statusCode = 302;
                 data.res.setHeader('location', data.req.url ?? '');
+                lCore.writeHead(data.res, 302);
                 data.res.end('');
                 return true;
             }
@@ -491,15 +491,15 @@ export async function run(data) {
             if (pathRight.startsWith('_') || pathRight === 'onUpgrade' || pathRight === 'onLoad' || pathRight === 'onData' || pathRight === 'onDrain' || pathRight === 'onEnd' || pathRight === 'onClose' || pathRight === 'setPrototype' || pathRight === 'getPrototype' || pathRight === 'getAuthorization') {
                 // --- _ 开头的 action 是内部方法，不允许访问 ---
                 if (config.route['#404']) {
-                    data.res.statusCode = 302;
                     data.res.setHeader('location', lText.urlResolve(config.const.urlBase, config.route['#404']));
+                    lCore.writeHead(data.res, 302);
                     data.res.end('');
                     return true;
                 }
                 const content = '[Error] Action not found, path: ' + path + '.';
-                data.res.statusCode = 404;
                 data.res.setHeader('content-type', 'text/html; charset=utf-8');
                 data.res.setHeader('content-length', Buffer.byteLength(content));
+                lCore.writeHead(data.res, 404);
                 data.res.end(content);
                 return true;
             }
@@ -508,15 +508,15 @@ export async function run(data) {
             });
             if (cctr[pathRight] === undefined) {
                 if (config.route['#404']) {
-                    data.res.statusCode = 302;
                     data.res.setHeader('location', lText.urlResolve(config.const.urlBase, config.route['#404']));
+                    lCore.writeHead(data.res, 302);
                     data.res.end('');
                     return true;
                 }
                 const content = '[Error] Action not found, path: ' + path + '.';
-                data.res.statusCode = 404;
                 data.res.setHeader('content-type', 'text/html; charset=utf-8');
                 data.res.setHeader('content-length', Buffer.byteLength(content));
+                lCore.writeHead(data.res, 404);
                 data.res.end(content);
                 return true;
             }
@@ -541,9 +541,9 @@ export async function run(data) {
                     catch (e) {
                         lCore.log(cctr, '(E05)' + lText.stringifyJson(e.stack).slice(1, -1), '-error');
                         const content = '<h1>500 Server Error</h1><hr>Kebab';
-                        data.res.statusCode = 500;
                         data.res.setHeader('content-type', 'text/html; charset=utf-8');
                         data.res.setHeader('content-length', Buffer.byteLength(content));
+                        lCore.writeHead(data.res, 500);
                         data.res.end(content);
                         await waitCtr(cctr);
                         return true;
@@ -556,9 +556,9 @@ export async function run(data) {
             catch (e) {
                 lCore.log(cctr, '(E04)' + lText.stringifyJson(e.stack).slice(1, -1), '-error');
                 const content = '<h1>500 Server Error</h1><hr>Kebab';
-                data.res.statusCode = 500;
                 data.res.setHeader('content-type', 'text/html; charset=utf-8');
                 data.res.setHeader('content-length', Buffer.byteLength(content));
+                lCore.writeHead(data.res, 500);
                 data.res.end(content);
                 await waitCtr(cctr);
                 return true;
@@ -580,7 +580,7 @@ export async function run(data) {
             // --- 已经自行输出过 writeHead，可能自行处理了内容，如 pipe，则不再 writeHead ---
         }
         else {
-            data.res.statusCode = data.res.getHeader('location') ? 302 : httpCode;
+            lCore.writeHead(data.res, data.res.getHeader('location') ? 302 : httpCode);
         }
         if (!data.res.writableEnded) {
             // --- 如果当前还没结束，则强制关闭连接，一切 pipe 请自行在方法中 await，否则会被中断 ---
@@ -603,7 +603,7 @@ export async function run(data) {
                     data.res.setHeader('content-encoding', compress.type);
                 }
             }
-            data.res.statusCode = httpCode;
+            lCore.writeHead(data.res, httpCode);
         }
         if (!data.res.writableEnded) {
             if (compress) {
@@ -634,7 +634,7 @@ export async function run(data) {
             if (compress) {
                 data.res.setHeader('content-encoding', compress.type);
             }
-            data.res.statusCode = httpCode;
+            lCore.writeHead(data.res, httpCode);
         }
         if (!data.res.writableEnded) {
             if (compress) {
@@ -652,7 +652,7 @@ export async function run(data) {
             if (rtn.length === 0) {
                 // --- 异常 ---
                 if (!data.res.headersSent) {
-                    data.res.statusCode = 500;
+                    lCore.writeHead(data.res, 500);
                 }
                 if (!data.res.writableEnded) {
                     data.res.end('<h1>500 Internal server error</h1><hr>Kebab');
@@ -688,7 +688,7 @@ export async function run(data) {
                                 data.res.setHeader('content-encoding', compress.type);
                             }
                         }
-                        data.res.statusCode = httpCode;
+                        lCore.writeHead(data.res, httpCode);
                     }
                     if (!data.res.writableEnded) {
                         if (compress) {
@@ -713,7 +713,7 @@ export async function run(data) {
                         if (compress) {
                             data.res.setHeader('content-encoding', compress.type);
                         }
-                        data.res.statusCode = httpCode;
+                        lCore.writeHead(data.res, httpCode);
                     }
                     if (!data.res.writableEnded) {
                         const passThrough = new stream.PassThrough();
@@ -742,7 +742,7 @@ export async function run(data) {
                         data.res.setHeader('content-encoding', compress.type);
                     }
                 }
-                data.res.statusCode = httpCode;
+                lCore.writeHead(data.res, httpCode);
             }
             if (!data.res.writableEnded) {
                 if (compress) {
@@ -759,7 +759,7 @@ export async function run(data) {
     else {
         // --- 异常 ---
         if (!data.res.headersSent) {
-            data.res.statusCode = 500;
+            lCore.writeHead(data.res, 500);
         }
         if (!data.res.writableEnded) {
             data.res.end('<h1>500 Internal server error</h1><hr>Kebab');

package/www/example/ctr/test.d.ts

@@ -24,7 +24,9 @@ export default class extends sCtr.Ctr {
     ctrCross2(): kebab.Json[];
     ctrReadable(): fs.ReadStream;
     ctrAsynctask(): any[];
-    ctrTimeout(): Promise<any[]>;
+    ctrTimeoutLong(): Promise<any[]>;
+    ctrTimeoutShort(): Promise<any[]>;
+    ctr500(): Promise<void>;
     modTest(): Promise<kebab.Json[] | string | boolean>;
     modSplit(): Promise<string>;
     modSplit1(): Promise<void>;

package/www/example/ctr/test.js

@@ -76,6 +76,7 @@ export default class extends sCtr.Ctr {
             '<br>QS: ' + this._config.const.qs,
             '<br>HTTPS: ' + (this._config.const.https ? 'true' : 'false'),
             '<br>MOBILE: ' + (this._config.const.mobile ? 'true' : 'false'),
+            '<br>MINIPROGRAM: ' + (this._config.const.miniprogram) + ' (' + typeof this._config.const.miniprogram + ')',
             '<br>Real IP: ' + lCore.ip(this),
             '<br>Client IP: ' + lCore.realIP(this),
             '<br><br>URL_BASE: ' + this._config.const.urlBase,
@@ -112,7 +113,9 @@ export default class extends sCtr.Ctr {
             `<br><a href="${this._config.const.urlBase}test/ctr-cross">View "test/ctr-cross"</a>`,
             `<br><a href="${this._config.const.urlBase}test/ctr-readable">View "test/ctr-readable"</a>`,
             `<br><a href="${this._config.const.urlBase}test/ctr-asynctask">View "test/ctr-asynctask"</a>`,
-            `<br><a href="${this._config.const.urlBase}test/ctr-timeout">View "test/ctr-timeout"</a>`,
+            `<br><a href="${this._config.const.urlBase}test/ctr-timeout-long">View "test/ctr-timeout-long"</a>`,
+            `<br><a href="${this._config.const.urlBase}test/ctr-timeout-short">View "test/ctr-timeout-short"</a>`,
+            `<br><a href="${this._config.const.urlBase}test/ctr-500">View "test/ctr-500"</a>`,
             '<br><br><b>Middle:</b>',
             `<br><br><a href="${this._config.const.urlBase}test/middle">View "test/middle"</a>`,
             '<br><br><b>Model test:</b>',
@@ -509,7 +512,7 @@ Result:<pre id="result">Nothing.</pre>` + this._getEnd();
         });
         return [1];
     }
-    async ctrTimeout() {
+    async ctrTimeoutLong() {
         this.timeout = 70_000;
         const echo = ['1'];
         await lCore.sleep(15_000);
@@ -520,7 +523,25 @@ Result:<pre id="result">Nothing.</pre>` + this._getEnd();
         echo.push('4');
         await lCore.sleep(15_000);
         echo.push('5');
-        return [1, echo];
+        return [1, { 'list': echo }];
+    }
+    async ctrTimeoutShort() {
+        this.timeout = 5_000;
+        const echo = ['1'];
+        await lCore.sleep(15_000);
+        echo.push('2');
+        await lCore.sleep(15_000);
+        echo.push('3');
+        await lCore.sleep(15_000);
+        echo.push('4');
+        await lCore.sleep(15_000);
+        echo.push('5');
+        return [1, { 'list': echo }];
+    }
+    async ctr500() {
+        await lCore.sleep(100);
+        lCore.writeHead(this._res, 200);
+        lCore.debug('DEBUG', this._res.abc.def);
     }
     async modTest() {
         const retur = [];