@idlebox/common 1.5.13 → 1.5.14

package/src/error/pretty.nodejs.ts

@@ -1,41 +1,14 @@
-import { isAbsolute } from '../path/isAbsolute.js';
 import { relativePath } from '../path/normalizePath.js';
 import { globalObject } from '../platform/globalObject.js';
 import { isNative } from '../platform/os.js';
 import { vscEscapeValue } from './pretty.vscode.js';
+import { parseStackLine, type IStructreStackLine } from './stack-parser.v8.js';
 import { createStackTraceHolder } from './stack-trace.js';
 
 const process = globalObject.process;
 const window = globalObject.window;
 
-const padding = /^(?<padding> {4})at /.source;
-const func_call = /(?<func_name>(?:(?:async|new) )?[^/\\\s]+) (?:\[as (?<func_alias>[^\]]+)] )?/.source;
-//                              xxxx.yyyyy [as eval]
-const line_column = /(?::(?<line>\d+))?(?::(?<column>\d+))?/.source;
-const locationEsm = /(?<schema>node:|file:\/\/|https?:\/\/)?(?<path2>[^:]+)/.source;
-//                        node:internal/modules/cjs/loader.js:883:14
-const locationCjs = /(?<path1>(?:\/|[a-zA-Z]:)[^:]+)/.source;
-//                          /data/to/file.js
-const location = `(?:${locationCjs}|${locationEsm})${line_column}`;
-
-const regNormal = new RegExp(`${padding}${func_call}\\(${location}\\)$`);
-type TypeMatchNormal = 'padding' | TypeMatchNoFile | TypeMatchFileOnly;
-
-const regNoFile = new RegExp(`${padding}${func_call}$`);
-type TypeMatchNoFile = 'padding' | 'func_name' | 'func_alias';
-
-const regFileOnly = new RegExp(`${padding}${location}$`);
-type TypeMatchFileOnly = 'padding' | 'schema' | 'path1' | 'path2' | 'line' | 'column';
-
-const regEvalItem = new RegExp(`\\(eval at ${func_call}`, 'g');
-const eval_source = /, (?<eval_func>[\S]+):(?<eval_line>\d+):(?<eval_column>\d+)/.source;
-const regEval = new RegExp(`${padding}${func_call}.*?\\(${location}\\)+${eval_source}`);
-type TypeMatchEval = 'padding' | TypeMatchNoFile | TypeMatchFileOnly | 'eval_func' | 'eval_line' | 'eval_column';
-
-const regInvalid = new RegExp(`${padding}(?<content>.+) \\(${location}\\)$`);
-type TypeMatchInvalid = TypeMatchFileOnly | 'content';
-
-let root = process?.cwd?.() ?? window?.location?.domain ?? '/';
+let errorRootPath = process?.cwd?.() ?? window?.location?.domain ?? '/';
 export function setErrorLogRoot(_root: string) {
 	if (
 		typeof process !== 'undefined' &&
@@ -44,132 +17,7 @@ export function setErrorLogRoot(_root: string) {
 	) {
 		process.stderr.write(`\x1B]633;P;Cwd=${vscEscapeValue(_root)}\x07`);
 	}
-	root = _root;
-}
-
-interface IFunction {
-	name: string;
-	alias?: string;
-}
-interface IFileLocation {
-	path: string;
-	schema: string; // '' | 'node:' | 'file:' | 'http:' | 'https:';
-	line: number;
-	column: number;
-	isAbsolute: boolean;
-}
-interface IEvalDef {
-	eval_func: string;
-	eval_line: number;
-	eval_column: number;
-	funcs: string[];
-}
-
-export interface IStructreStackLine {
-	invalid?: boolean;
-	special?: boolean;
-	toString(): string;
-	padding?: string;
-	func?: IFunction;
-	location?: IFileLocation;
-	eval?: IEvalDef;
-	_matches?: RegExp;
-}
-
-function matchLine<T extends string>(line: string, reg: RegExp): null | Record<T, string> {
-	const m = reg.exec(line);
-	if (!m) {
-		return null;
-	}
-	return m.groups as any;
-}
-const endingSlashes = /\/+$/;
-function addLoc(ret: IStructreStackLine, m: Record<TypeMatchFileOnly, string>) {
-	const path = m.path1 || m.path2;
-	ret.location = {
-		schema: m.schema?.replace(endingSlashes, '') ?? '',
-		path: path,
-		line: Number.parseInt(m.line, 10),
-		column: Number.parseInt(m.column, 10),
-		isAbsolute: isAbsolute(path),
-	};
-}
-
-function addFunc(ret: IStructreStackLine, m: Record<TypeMatchNoFile, string>) {
-	ret.func = {
-		name: m.func_name,
-		alias: m.func_alias,
-	};
-}
-
-export function parseStackLine(line: string): IStructreStackLine {
-	const __raw = line;
-	const ret: IStructreStackLine = {
-		invalid: false,
-		toString() {
-			return __raw;
-		},
-	};
-	Object.assign(ret, { __raw });
-
-	const mNormal = matchLine<TypeMatchNormal>(line, regNormal);
-	if (mNormal) {
-		ret._matches = regNormal;
-		ret.padding = mNormal.padding;
-		addFunc(ret, mNormal);
-		addLoc(ret, mNormal);
-		return ret;
-	}
-
-	const mFile = matchLine<TypeMatchFileOnly>(line, regFileOnly);
-	if (mFile) {
-		ret._matches = regFileOnly;
-		ret.padding = mFile.padding;
-		addLoc(ret, mFile);
-		return ret;
-	}
-
-	const mNoFile = matchLine<TypeMatchNoFile>(line, regNoFile);
-	if (mNoFile) {
-		ret._matches = regNoFile;
-		ret.padding = mNoFile.padding;
-		addFunc(ret, mNoFile);
-		return ret;
-	}
-
-	const mEval = matchLine<TypeMatchEval>(line.replaceAll(regEvalItem, ''), regEval);
-	if (mEval) {
-		ret._matches = regEval;
-		ret.padding = mEval.padding;
-		addFunc(ret, mEval);
-		addLoc(ret, mEval);
-
-		ret.eval = {
-			eval_column: Number.parseInt(mEval.eval_column, 10),
-			eval_func: mEval.eval_func,
-			eval_line: Number.parseInt(mEval.eval_line, 10),
-			funcs: [],
-		};
-		for (const item of line.matchAll(regEvalItem)) {
-			// biome-ignore lint/style/noNonNullAssertion: 有匹配必然有 groups
-			ret.eval.funcs.push(item.groups!['func_name']);
-		}
-		ret.eval.funcs.push(mEval.eval_func);
-
-		return ret;
-	}
-
-	const mInv = matchLine<TypeMatchInvalid>(line, regInvalid);
-	if (mInv) {
-		const path = mInv.path1 || mInv.path2;
-		if (path.endsWith(mInv.content)) {
-			addLoc(ret, mInv);
-			return ret;
-		}
-	}
-
-	ret.invalid = true;
-	return ret;
+	errorRootPath = _root;
 }
 
 function isPrettyDisabled() {
@@ -193,10 +41,34 @@ export function prettyPrintError<ErrorType extends IError = IError>(type: string
 
 	const columns = process?.stderr?.columns || 80;
 	const line = '-'.repeat(columns);
-	console.error(`\n${line}\n[${type}] ${prettyFormatError(e, true, prettyPrintError)}`);
-	if (e.cause && typeof e.cause === 'object' && 'stack' in e.cause) {
-		console.error(`[Caused by] ${prettyFormatError(e.cause as IError, true, prettyPrintError)}`);
+	console.error(line);
+
+	console.error(`[${type}] ${prettyFormatError(e, true, false)}`);
+
+	let cause = e.cause;
+	while (cause && typeof cause === 'object' && 'stack' in cause) {
+		console.error(`[Caused by] ${prettyFormatError(cause as IError, true, false)}`);
+		cause = (cause as IError).cause;
+	}
+
+	const structured = [];
+	if (isSelfPrint()) {
+		structured.push({
+			special: true,
+			toString() {
+				return '== Above error was printed at:';
+			},
+		});
+
+		const selfStack = createStackTraceHolder('111', prettyPrintError);
+		const stackLines = selfStack.stack.split(/\n/g).slice(1);
+		structured.push(...stackLines.map(parseStackLine));
 	}
+
+	const formatter = new Formatter();
+	const txt = structured.filter(formatter.skipSomeFrame).map(formatter.translateFunction).map(formatter.stringifyLine).join('\n');
+	console.error(txt);
+
 	console.error(line);
 
 	if (!notify_printed && e.stack && e.message !== e.stack) {
@@ -212,28 +84,24 @@ function red(s: string) {
 	return isNative ? `\x1B[38;5;9m${s}\x1B[0m` : s;
 }
 
-export function parseStackString(stack: string) {
-	return stack.split('\n').map(parseStackLine);
-}
-
 /**
  * Format a stack trace for display.
  * @param stackLines The stack lines to format.
  */
 export function prettyFormatStack(stackLines: readonly string[]): string[];
 /** @internal */
-export function prettyFormatStack(stackLines: readonly string[], boundary?: CallableFunction): string[];
-export function prettyFormatStack(stackLines: readonly string[], boundary: CallableFunction = prettyFormatStack): string[] {
+export function prettyFormatStack(stackLines: readonly string[], boundary: CallableFunction | false): string[];
+export function prettyFormatStack(stackLines: readonly string[], boundary: CallableFunction | false = prettyFormatStack): string[] {
 	if (isPrettyDisabled()) {
 		return stackLines.slice();
 	}
 	const structured: IStructreStackLine[] = stackLines.map(parseStackLine);
 
-	if (isSelfPrint()) {
+	if (boundary && isSelfPrint()) {
 		structured.push({
 			special: true,
 			toString() {
-				return '== Above error was printed at here:';
+				return '== Above error was formatted at:';
 			},
 		});
 
@@ -242,93 +110,8 @@ export function prettyFormatStack(stackLines: readonly string[], boundary: Calla
 		structured.push(...stackLines.map(parseStackLine));
 	}
 
-	let messageEnded = false;
-	return structured
-		.filter(skipSomeFrame)
-		.map(translateFunction)
-		.map((line) => {
-			let ret: string;
-			if (line.special) {
-				return line.toString();
-			}
-			if (line.invalid) {
-				if (messageEnded) {
-					return red(line.toString());
-				}
-				return line.toString();
-			}
-			messageEnded = true;
-			const fn_name = line.func?.name;
-
-			if (!line.location?.isAbsolute || line.location.schema === 'node:') {
-				// no-path, relative path, node:
-				ret = '  at \x1B[2m';
-				if (line.func) {
-					ret += fn_name;
-					if (line.func.alias) {
-						ret += ` [${line.func.alias}]`;
-					}
-				}
-
-				if (line.location?.path === '<anonymous>') {
-				} else if (line.location?.path) {
-					if (fn_name) {
-						ret += ' (';
-					}
-					ret += formatFileLine(line.location.schema, line.location.path, line.location.line, line.location.column);
-					if (fn_name) {
-						ret += ')';
-					}
-				}
-				ret += '\x1B[0m';
-			} else {
-				const path = line.location.path;
-				const isNodeModule = path.includes('/node_modules/');
-				const fn_alias = line.func?.alias;
-
-				const color = fn_name ? (isNodeModule ? '14;2' : '14') : '8';
-				ret = `\x1b[0m  at \x1b[38;5;${color}m`;
-				if (fn_alias && fn_name && fn_name.startsWith('Object.')) {
-					ret += `${fn_alias} [export]`;
-				} else {
-					ret += formatFunctionName(fn_name, fn_alias);
-				}
-				ret += '\x1b[0m';
-				if (line.eval) {
-					ret += `\x1b[2m(${line.eval.funcs.filter((e) => e !== '<anonymous>').join('->')})\x1b[0m`;
-				}
-
-				if (path) {
-					let color: string;
-					if (isNodeModule) {
-						color = '\x1b[38;5;237m';
-					} else {
-						color = '\x1b[38;5;2m';
-					}
-					ret += ` (${color}`;
-					const file = formatFileLine(line.location.schema, path, line.location.line, line.location.column);
-					const lastNmPos = file.lastIndexOf('/node_modules/');
-					if (lastNmPos >= 0) {
-						ret += file.slice(0, lastNmPos + 14);
-
-						let nextSlash = file.indexOf('/', lastNmPos + 15);
-						const scopePkg = file[lastNmPos + 14] === '@';
-						if (scopePkg) {
-							nextSlash = file.indexOf('/', nextSlash + 1);
-						}
-
-						ret += '\x1B[0m';
-						ret += file.slice(lastNmPos + 14, nextSlash);
-						ret += color;
-						ret += file.slice(nextSlash);
-					} else {
-						ret += file;
-					}
-					ret += '\x1B[0m)';
-				}
-			}
-			return ret;
-		});
+	const formatter = new Formatter();
+	return structured.filter(formatter.skipSomeFrame).map(formatter.translateFunction).map(formatter.stringifyLine);
 }
 
 interface IError {
@@ -350,8 +133,8 @@ const regErrorClassName = /^(\S+):/;
  */
 export function prettyFormatError<ErrorType extends IError = IError>(e: ErrorType, withMessage?: boolean): string;
 /** @internal */
-export function prettyFormatError<ErrorType extends IError = IError>(e: ErrorType, withMessage?: boolean, boundary?: CallableFunction): string;
-export function prettyFormatError<ErrorType extends IError = IError>(e: ErrorType, withMessage = true, boundary: CallableFunction = prettyFormatError) {
+export function prettyFormatError<ErrorType extends IError = IError>(e: ErrorType, withMessage?: boolean, boundary?: CallableFunction | false): string;
+export function prettyFormatError<ErrorType extends IError = IError>(e: ErrorType, withMessage = true, boundary: CallableFunction | false = prettyFormatError) {
 	if (!e || !e.stack) {
 		if (withMessage) {
 			const msg = e?.message || 'Unknown Error';
@@ -382,107 +165,201 @@ export function prettyFormatError<ErrorType extends IError = IError>(e: ErrorTyp
 	return prettyFormatStack(stackLines, boundary).join('\n');
 }
 
-function formatFileLine(schema: string | undefined, file: string, row?: number, col?: number) {
-	let rel = file;
-
-	if (schema !== 'node:') {
-		try {
-			rel = relativePath(root, file);
-			if (rel[0] !== '.') {
-				rel = `./${rel}`;
-			} else if (rel[1] === '.') {
-				if (file.length < rel.length) {
-					rel = file;
+class Formatter {
+	private messageEnded = false;
+
+	constructor() {
+		this.stringifyLine = this.stringifyLine.bind(this);
+		this.translateFunction = this.translateFunction.bind(this);
+		this.skipSomeFrame = this.skipSomeFrame.bind(this);
+	}
+
+	private formatFileLine(schema: string | undefined, file: string, row?: number, col?: number) {
+		let rel = file;
+
+		if (schema !== 'node:') {
+			try {
+				rel = relativePath(errorRootPath, file);
+				if (rel[0] !== '.') {
+					rel = `./${rel}`;
+				} else if (rel[1] === '.') {
+					if (file.length < rel.length) {
+						rel = file;
+					}
 				}
+				if (rel[0] === '.') {
+					schema = '';
+				}
+			} catch {
+				// if (!alert) {
+				// 	alert = true;
+				// 	console.error('pretty print failed parse line: \n\x1B[2mFormat%s\x1B[0m', e.stack);
+				// }
+				rel = file;
 			}
-			if (rel[0] === '.') {
-				schema = '';
-			}
-		} catch {
-			// if (!alert) {
-			// 	alert = true;
-			// 	console.error('pretty print failed parse line: \n\x1B[2mFormat%s\x1B[0m', e.stack);
-			// }
-			rel = file;
 		}
-	}
 
-	return `${schema || ''}${rel}${row ? `:${row}` : ''}${col ? `:${col}` : ''}`;
-}
+		return `${schema || ''}${rel}${row ? `:${row}` : ''}${col ? `:${col}` : ''}`;
+	}
 
-function formatFunctionName(fn?: string, as?: string) {
-	if (fn) {
-		if (as) {
-			return `${fn} [as ${as}]`;
+	private formatFunctionName(fn?: string, as?: string) {
+		if (fn) {
+			if (as) {
+				return `${fn} [as ${as}]`;
+			}
+			return fn;
 		}
-		return fn;
+		return '<anonymous>';
 	}
-	return '<anonymous>';
-}
 
-function translateFunction(data: IStructreStackLine): IStructreStackLine {
-	if (!data.func?.name) {
-		return data;
-	}
-	if (data.func.name === 'Timeout._onTimeout') {
-		data.func.name = 'setTimeout';
-	}
-	if (data.func.name === 'Immediate._onImmediate') {
-		data.func.name = 'setImmediate';
-	}
-	if (data.func.name === 'process.processTicksAndRejections') {
-		data.func.name = 'process.nextTick';
-	}
-	if (data.func.name.startsWith('Timeout.') && data.func.alias === '_onTimeout') {
-		data.func.name = `setTimeout->${data.func.name.slice(8)}`;
-		data.func.alias = undefined;
-	}
-	if (data.func.name.startsWith('async Promise.all')) {
-		data.func.name = `Promise.all()`;
-		data.func.alias = data.location?.path;
-		data.location = undefined;
-	}
-	return data;
-}
+	stringifyLine(line: IStructreStackLine) {
+		let ret: string;
+		if (line.special) {
+			return line.toString();
+		}
+		if (line.invalid) {
+			if (this.messageEnded) {
+				return red(line.toString());
+			}
+			return line.toString();
+		}
+		this.messageEnded = true;
+		const fn_name = line.func?.name;
+
+		if (!line.location?.isAbsolute || line.location.schema === 'node:') {
+			// no-path, relative path, node:
+			ret = '  at \x1B[2m';
+			if (line.func) {
+				ret += fn_name;
+				if (line.func.alias) {
+					ret += ` [${line.func.alias}]`;
+				}
+			}
 
-/**
- *
- */
-function skipSomeFrame({ func, location }: IStructreStackLine): boolean {
-	if (!location?.path) {
-		return true;
+			if (line.location?.path === '<anonymous>') {
+			} else if (line.location?.path) {
+				if (fn_name) {
+					ret += ' (';
+				}
+				ret += this.formatFileLine(line.location.schema, line.location.path, line.location.line, line.location.column);
+				if (fn_name) {
+					ret += ')';
+				}
+			}
+			ret += '\x1B[0m';
+		} else {
+			const path = line.location.path;
+			const isNodeModule = path.includes('/node_modules/');
+			const fn_alias = line.func?.alias;
+
+			const color = fn_name ? (isNodeModule ? '14;2' : '14') : '8';
+			ret = `\x1b[0m  at \x1b[38;5;${color}m`;
+			if (fn_alias && fn_name && fn_name.startsWith('Object.')) {
+				ret += `${fn_alias} [export]`;
+			} else {
+				ret += this.formatFunctionName(fn_name, fn_alias);
+			}
+			ret += '\x1b[0m';
+			if (line.eval) {
+				ret += `\x1b[2m(${line.eval.funcs.filter((e) => e !== '<anonymous>').join('->')})\x1b[0m`;
+			}
+
+			if (path) {
+				let color: string;
+				if (isNodeModule) {
+					color = '\x1b[38;5;237m';
+				} else {
+					color = '\x1b[38;5;2m';
+				}
+				ret += ` (${color}`;
+				const file = this.formatFileLine(line.location.schema, path, line.location.line, line.location.column);
+				const lastNmPos = file.lastIndexOf('/node_modules/');
+				if (lastNmPos >= 0) {
+					ret += file.slice(0, lastNmPos + 14);
+
+					let nextSlash = file.indexOf('/', lastNmPos + 15);
+					const scopePkg = file[lastNmPos + 14] === '@';
+					if (scopePkg) {
+						nextSlash = file.indexOf('/', nextSlash + 1);
+					}
+
+					ret += '\x1B[0m';
+					ret += file.slice(lastNmPos + 14, nextSlash);
+					ret += color;
+					ret += file.slice(nextSlash);
+				} else {
+					ret += file;
+				}
+				ret += '\x1B[0m)';
+			}
+		}
+		return ret;
 	}
 
-	if (location.schema === 'node:') {
-		if (location.path.startsWith('internal/timers')) {
-			return false;
+	translateFunction(data: IStructreStackLine): IStructreStackLine {
+		if (!data.func?.name) {
+			return data;
 		}
-		if (location.path === 'internal/modules/cjs/loader') {
-			return false;
+		if (data.func.name === 'Timeout._onTimeout') {
+			data.func.name = 'setTimeout';
 		}
-		if (location.path === 'internal/modules/esm/loader') {
-			return false;
+		if (data.func.name === 'Immediate._onImmediate') {
+			data.func.name = 'setImmediate';
 		}
-		if (location.path === 'internal/modules/run_main') {
-			return false;
+		if (data.func.name === 'process.processTicksAndRejections') {
+			data.func.name = 'process.nextTick';
 		}
-		if (location.path === 'internal/modules/esm/module_job') {
-			return false;
+		if (data.func.name.startsWith('Timeout.') && data.func.alias === '_onTimeout') {
+			data.func.name = `setTimeout->${data.func.name.slice(8)}`;
+			data.func.alias = undefined;
 		}
-	}
-	if (!location.path.includes('/')) {
-		if (location.path.startsWith('_stream_')) {
-			return false;
+		if (data.func.name.startsWith('async Promise.all')) {
+			data.func.name = `Promise.all()`;
+			data.func.alias = data.location?.path;
+			data.location = undefined;
 		}
+		return data;
 	}
-	if (location.path === '<anonymous>') {
-		// new Promise ('<anonymous>')
-		if (func?.name === 'new Promise') {
-			return false;
+
+	/**
+	 *
+	 */
+	skipSomeFrame({ func, location }: IStructreStackLine): boolean {
+		if (!location?.path) {
+			return true;
+		}
+
+		if (location.schema === 'node:') {
+			if (location.path.startsWith('internal/timers')) {
+				return false;
+			}
+			if (location.path === 'internal/modules/cjs/loader') {
+				return false;
+			}
+			if (location.path === 'internal/modules/esm/loader') {
+				return false;
+			}
+			if (location.path === 'internal/modules/run_main') {
+				return false;
+			}
+			if (location.path === 'internal/modules/esm/module_job') {
+				return false;
+			}
+		}
+		if (!location.path.includes('/')) {
+			if (location.path.startsWith('_stream_')) {
+				return false;
+			}
 		}
-		if (func?.name === 'new Function') {
-			return false;
+		if (location.path === '<anonymous>') {
+			// new Promise ('<anonymous>')
+			if (func?.name === 'new Promise') {
+				return false;
+			}
+			if (func?.name === 'new Function') {
+				return false;
+			}
 		}
+		return true;
 	}
-	return true;
 }