// API for node internals to override error stack formatting

// without interfering with userland code.

if (overrideStackTrace.has(error)) {

const f = overrideStackTrace.get(error);

overrideStackTrace.delete(error);

return f(error, trace);

}

const globalOverride =

maybeOverridePrepareStackTrace(globalThis, error, trace);

if (globalOverride !== kNoOverride) return globalOverride;

// Normal error formatting:

//

// Error: Message

// at function (file)

// at file

let errorString;

if (kIsNodeError in error) {

errorString = `${error.name} [${error.code}]: ${error.message}`;

} else {

errorString = ErrorPrototypeToString(error);

}

if (trace.length === 0) {

return errorString;

}

return `${errorString}\n at ${ArrayPrototypeJoin(trace, '\n at ')}`;

// Polyfill of V8's Error.prepareStackTrace API.

// https://crbug.com/v8/7848

// `globalThis` is the global that contains the constructor which

// created `error`.

if (typeof globalThis.Error?.prepareStackTrace === 'function') {

return globalThis.Error.prepareStackTrace(error, trace);

}

// We still have legacy usage that depends on the main context's `Error`

// being used, even when the error is from a different context.

// TODO(devsnek): evaluate if this can be eventually deprecated/removed.

if (typeof MainContextError.prepareStackTrace === 'function') {

return MainContextError.prepareStackTrace(error, trace);

}

return kNoOverride;

if (innerError && outerError && innerError !== outerError) {

if (ArrayIsArray(outerError.errors)) {

// If `outerError` is already an `AggregateError`.

ArrayPrototypePush(outerError.errors, innerError);

return outerError;

}

let err;

if (isErrorStackTraceLimitWritable()) {

const limit = Error.stackTraceLimit;

Error.stackTraceLimit = 0;

// eslint-disable-next-line no-restricted-syntax

err = new AggregateError(new SafeArrayIterator([

outerError,

innerError,

]), outerError.message);

Error.stackTraceLimit = limit;

ErrorCaptureStackTrace(err, aggregateTwoErrors);

} else {

// eslint-disable-next-line no-restricted-syntax

err = new AggregateError(new SafeArrayIterator([

outerError,

innerError,

]), outerError.message);

}

err.code = outerError.code;

return err;

}

return innerError || outerError;

constructor(errors, message) {

super(new SafeArrayIterator(errors), message);

this.code = errors[0]?.code;

}

get [kIsNodeError]() {

return true;

}

get ['constructor']() {

return AggregateError;

}

// Do no touch Error.stackTraceLimit as V8 would attempt to install

// it again during deserialization.

if (require('internal/v8/startup_snapshot').namespace.isBuildingSnapshot()) {

return false;

}

const desc = ObjectGetOwnPropertyDescriptor(Error, 'stackTraceLimit');

if (desc === undefined) {

return ObjectIsExtensible(Error);

}

return ObjectPrototypeHasOwnProperty(desc, 'writable') ?

desc.writable :

desc.set !== undefined;

const utilInspect = lazyInternalUtilInspect();

try {

return utilInspect.inspect(obj, options);

} catch {

return utilInspect.inspect(obj, { ...options, customInspect: false });

}

constructor(key, context) {

super();

const prefix = getMessage(key, [], this);

let message = `${prefix}: ${context.syscall} returned ` +

`${context.code} (${context.message})`;

if (context.path !== undefined)

message += ` ${context.path}`;

if (context.dest !== undefined)

message += ` => ${context.dest}`;

this.code = key;

ObjectDefineProperties(this, {

[kIsNodeError]: {

__proto__: null,

value: true,

enumerable: false,

writable: false,

configurable: true,

},

name: {

__proto__: null,

value: 'SystemError',

enumerable: false,

writable: true,

configurable: true,

},

message: {

__proto__: null,

value: message,

enumerable: false,

writable: true,

configurable: true,

},

info: {

__proto__: null,

value: context,

enumerable: true,

configurable: true,

writable: false,

},

errno: {

__proto__: null,

get() {

return context.errno;

},

set: (value) => {

context.errno = value;

},

enumerable: true,

configurable: true,

},

syscall: {

__proto__: null,

get() {

return context.syscall;

},

set: (value) => {

context.syscall = value;

},

enumerable: true,

configurable: true,

},

});

if (context.path !== undefined) {

// TODO(BridgeAR): Investigate why and when the `.toString()` was

// introduced. The `path` and `dest` properties in the context seem to

// always be of type string. We should probably just remove the

// `.toString()` and `Buffer.from()` operations and set the value on the

// context as the user did.

ObjectDefineProperty(this, 'path', {

__proto__: null,

get() {

return context.path != null ?

context.path.toString() : context.path;

},

set: (value) => {

context.path = value ?

lazyBuffer().from(value.toString()) : undefined;

},

enumerable: true,

configurable: true,

});

}

if (context.dest !== undefined) {

ObjectDefineProperty(this, 'dest', {

__proto__: null,

get() {

return context.dest != null ?

context.dest.toString() : context.dest;

},

set: (value) => {

context.dest = value ?

lazyBuffer().from(value.toString()) : undefined;

},

enumerable: true,

configurable: true,

});

}

}

toString() {

return `${this.name} [${this.code}]: ${this.message}`;

}

[SymbolFor('nodejs.util.inspect.custom')](recurseTimes, ctx) {

return lazyInternalUtilInspect().inspect(this, {

...ctx,

getters: true,

customInspect: false,

});

}

return class NodeError extends SystemError {

constructor(ctx) {

super(key, ctx);

}

};

class HideStackFramesError extends Base {

constructor(...args) {

if (isErrorStackTraceLimitWritable()) {

const limit = Error.stackTraceLimit;

Error.stackTraceLimit = 0;

super(...args);

Error.stackTraceLimit = limit;

} else {

super(...args);

}

}

// This is a workaround for wpt tests that expect that the error

// constructor has a `name` property of the base class.

get ['constructor']() {

return clazz;

}

}

return HideStackFramesError;

const msg = messages.get(key);

const expectedLength = typeof msg !== 'string' ? -1 : getExpectedArgumentLength(msg);

switch (expectedLength) {

case 0: {

class NodeError extends Base {

code = key;

constructor(...args) {

assert(

args.length === 0,

`Code: ${key}; The provided arguments length (${args.length}) does not ` +

`match the required ones (${expectedLength}).`,

);

super(msg);

}

// This is a workaround for wpt tests that expect that the error

// constructor has a `name` property of the base class.

get ['constructor']() {

return Base;

}

get [kIsNodeError]() {

return true;

}

toString() {

return `${this.name} [${key}]: ${this.message}`;

}

}

return NodeError;

}

case -1: {

class NodeError extends Base {

code = key;

constructor(...args) {

super();

ObjectDefineProperty(this, 'message', {

__proto__: null,

value: getMessage(key, args, this),

enumerable: false,

writable: true,

configurable: true,

});

}

// This is a workaround for wpt tests that expect that the error

// constructor has a `name` property of the base class.

get ['constructor']() {

return Base;

}

get [kIsNodeError]() {

return true;

}

toString() {

return `${this.name} [${key}]: ${this.message}`;

}

}

return NodeError;

}

default: {

class NodeError extends Base {

code = key;

constructor(...args) {

assert(

args.length === expectedLength,

`Code: ${key}; The provided arguments length (${args.length}) does not ` +

`match the required ones (${expectedLength}).`,

);

ArrayPrototypeUnshift(args, msg);

super(ReflectApply(lazyInternalUtilInspect().format, null, args));

}

// This is a workaround for wpt tests that expect that the error

// constructor has a `name` property of the base class.

get ['constructor']() {

return Base;

}

get [kIsNodeError]() {

return true;

}

toString() {

return `${this.name} [${key}]: ${this.message}`;

}

}

return NodeError;

}

}

function wrappedFn(...args) {

try {

return ReflectApply(fn, this, args);

} catch (error) {

Error.stackTraceLimit && ErrorCaptureStackTrace(error, wrappedFn);

throw error;

}

}

wrappedFn.withoutStackTrace = fn;

return wrappedFn;

// Special case for SystemError that formats the error message differently

// The SystemErrors only have SystemError as their base classes.

messages.set(sym, val);

const ErrClass = def === SystemError ?

makeSystemErrorWithCode(sym) :

makeNodeErrorWithCode(def, sym);

if (otherClasses.length !== 0) {

if (otherClasses.includes(HideStackFramesError)) {

if (otherClasses.length !== 1) {

otherClasses.forEach((clazz) => {

if (clazz !== HideStackFramesError) {

ErrClass[clazz.name] = makeNodeErrorWithCode(clazz, sym);

ErrClass[clazz.name].HideStackFramesError = makeNodeErrorForHideStackFrame(ErrClass[clazz.name], clazz);

}

});

}

} else {

otherClasses.forEach((clazz) => {

ErrClass[clazz.name] = makeNodeErrorWithCode(clazz, sym);

});

}

}

if (otherClasses.includes(HideStackFramesError)) {

ErrClass.HideStackFramesError = makeNodeErrorForHideStackFrame(ErrClass, def);

}

codes[sym] = ErrClass;

let expectedLength = 0;

const regex = /%[dfijoOs]/g;

while (RegExpPrototypeExec(regex, msg) !== null) expectedLength++;

return expectedLength;

const msg = messages.get(key);

if (typeof msg === 'function') {

assert(

msg.length <= args.length, // Default options do not count.

`Code: ${key}; The provided arguments length (${args.length}) does not ` +

`match the required ones (${msg.length}).`,

);

return ReflectApply(msg, self, args);

}

const expectedLength = getExpectedArgumentLength(msg);

assert(

expectedLength === args.length,

`Code: ${key}; The provided arguments length (${args.length}) does not ` +

`match the required ones (${expectedLength}).`,

);

if (args.length === 0)

return msg;

ArrayPrototypeUnshift(args, msg);

return ReflectApply(lazyInternalUtilInspect().format, null, args);

uvBinding = lazyUv();

uvBinding.errmap ??= uvBinding.getErrorMap();

return MapPrototypeGet(uvBinding.errmap, name);

/**

constructor(ctx) {

const { 0: code, 1: uvmsg } = uvErrmapGet(ctx.errno) || uvUnmappedError;

let message = `${code}: ${ctx.message || uvmsg}, ${ctx.syscall}`;

let path;

let dest;

if (ctx.path) {

path = ctx.path.toString();

message += ` '${path}'`;

}

if (ctx.dest) {

dest = ctx.dest.toString();

message += ` -> '${dest}'`;

}

super(message);

for (const prop of ObjectKeys(ctx)) {

if (prop === 'message' || prop === 'path' || prop === 'dest') {

continue;

}

this[prop] = ctx[prop];

}

this.code = code;

if (path) {

this.path = path;

}

if (dest) {

this.dest = dest;

}

}

get ['constructor']() {

return Error;

}

/**

constructor(err, syscall, address, port) {

const { 0: code, 1: uvmsg } = uvErrmapGet(err) || uvUnmappedError;

const message = `${syscall} ${code}: ${uvmsg}`;

let details = '';

if (port && port > 0) {

details = ` ${address}:${port}`;

} else if (address) {

details = ` ${address}`;

}

super(`${message}${details}`);

this.code = code;

this.errno = err;

this.syscall = syscall;

this.address = address;

if (port) {

this.port = port;

}

}

get ['constructor']() {

return Error;

}

/**

constructor(err, syscall, original) {

// TODO(joyeecheung): We have to use the type-checked

// getSystemErrorName(err) to guard against invalid arguments from users.

// This can be replaced with [ code ] = errmap.get(err) when this method

// is no longer exposed to user land.

util ??= require('util');

const code = util.getSystemErrorName(err);

const message = original ?

`${syscall} ${code} ${original}` : `${syscall} ${code}`;

super(message);

this.errno = err;

this.code = code;

this.syscall = syscall;

}

get ['constructor']() {

return Error;

}

constructor(err, syscall, address, port, additional) {

// TODO(joyeecheung): We have to use the type-checked

// getSystemErrorName(err) to guard against invalid arguments from users.

// This can be replaced with [ code ] = errmap.get(err) when this method

// is no longer exposed to user land.

util ??= require('util');

const code = util.getSystemErrorName(err);

let details = '';

if (port && port > 0) {

details = ` ${address}:${port}`;

} else if (address) {

details = ` ${address}`;

}

if (additional) {

details += ` - Local (${additional})`;

}

super(`${syscall} ${code}${details}`);

this.errno = err;

this.code = code;

this.syscall = syscall;

this.address = address;

if (port) {

this.port = port;

}

}

get ['constructor']() {

return Error;

}

/**

constructor(code, syscall, hostname) {

let errno;

// If `code` is of type number, it is a libuv error number, else it is a

// c-ares error code.

// TODO(joyeecheung): translate c-ares error codes into numeric ones and

// make them available in a property that's not error.errno (since they

// can be in conflict with libuv error codes). Also make sure

// util.getSystemErrorName() can understand them when an being informed that

// the number is a c-ares error code.

if (typeof code === 'number') {

errno = code;

// ENOTFOUND is not a proper POSIX error, but this error has been in place

// long enough that it's not practical to remove it.

if (code === lazyUv().UV_EAI_NODATA || code === lazyUv().UV_EAI_NONAME) {

code = 'ENOTFOUND'; // Fabricated error name.

} else {

code = lazyInternalUtil().getSystemErrorName(code);

}

}

super(`${syscall} ${code}${hostname ? ` ${hostname}` : ''}`);

this.errno = errno;

this.code = code;

this.syscall = syscall;

if (hostname) {

this.hostname = hostname;

}

}

get ['constructor']() {

return Error;

}

constructor(msg) {

super(msg);

this.code = 'ECONNRESET';

}

get ['constructor']() {

return Error;

}

if (maxStack_ErrorMessage === undefined) {

try {

function overflowStack() { overflowStack(); }

overflowStack();

} catch (err) {

maxStack_ErrorMessage = err.message;

maxStack_ErrorName = err.name;

}

}

return err && err.name === maxStack_ErrorName &&

err.message === maxStack_ErrorMessage;

let res = '';

let i = val.length;

const start = val[0] === '-' ? 1 : 0;

for (; i >= start + 4; i -= 3) {

res = `_${StringPrototypeSlice(val, i - 3, i)}${res}`;

}

return `${StringPrototypeSlice(val, 0, i)}${res}`;

if (typeof error[kEnhanceStackBeforeInspector] !== 'function') {

return error.stack;

}

try {

// Set the error.stack here so it gets picked up by the

// inspector.

error.stack = error[kEnhanceStackBeforeInspector]();

} catch {

// We are just enhancing the error. If it fails, ignore it.

}

return error.stack;

const originalStack = error.stack;

let useColors = true;

// Some consoles do not convert ANSI escape sequences to colors,

// rather display them directly to the stdout. On those consoles,

// libuv emulates colors by intercepting stdout stream and calling

// corresponding Windows API functions for setting console colors.

// However, fatal error are handled differently and we cannot easily

// highlight them. On Windows, detecting whether a console supports

// ANSI escape sequences is not reliable.

if (isWindows) {

const info = internalBinding('os').getOSInformation();

const ver = ArrayPrototypeMap(StringPrototypeSplit(info[2], '.'),

Number);

if (ver[0] !== 10 || ver[2] < 14393) {

useColors = false;

}

}

const {

inspect,

inspectDefaultOptions: {

colors: defaultColors,

},

} = lazyInternalUtilInspect();

const colors = useColors && (lazyUtilColors().shouldColorize(process.stderr) || defaultColors);

try {

return inspect(error, {

colors,

customInspect: false,

depth: MathMax(inspect.defaultOptions.depth, 5),

});

} catch {

return originalStack;

}

overrideStackTrace.set(error, (error, stackFrames) => {

let frames = stackFrames;

if (typeof stackFrames === 'object') {

frames = ArrayPrototypeFilter(

stackFrames,

(frm) => !StringPrototypeStartsWith(frm.getFileName() || '',

'node:internal'),

);

}

ArrayPrototypeUnshift(frames, error);

return ArrayPrototypeJoin(frames, '\n at ');

});

constructor(message = 'The operation was aborted', options = undefined) {

if (options !== undefined && typeof options !== 'object') {

throw new codes.ERR_INVALID_ARG_TYPE('options', 'Object', options);

}

super(message, options);

this.code = 'ABORT_ERR';

this.name = 'AbortError';

}