/* eslint node-core/documented-errors: "error" */

/* eslint node-core/alphabetize-errors: ["error", {checkErrorDeclarations: true}] */

/* eslint node-core/prefer-util-format-errors: "error" */

'use strict';

// The whole point behind this internal module is to allow Node.js to no

// longer be forced to treat every error message change as a semver-major

// change. The NodeError classes here all expose a `code` property whose

// value statically and permanently identifies the error. While the error

// message may change, the code should not.

const {

AggregateError,

ArrayIsArray,

ArrayPrototypeFilter,

ArrayPrototypeIncludes,

ArrayPrototypeIndexOf,

ArrayPrototypeJoin,

ArrayPrototypeMap,

ArrayPrototypePush,

ArrayPrototypeSlice,

ArrayPrototypeSplice,

ArrayPrototypeUnshift,

Error,

ErrorCaptureStackTrace,

ErrorPrototypeToString,

JSONStringify,

MapPrototypeGet,

MathAbs,

MathMax,

Number,

NumberIsInteger,

ObjectAssign,

ObjectDefineProperties,

ObjectDefineProperty,

ObjectGetOwnPropertyDescriptor,

ObjectIsExtensible,

ObjectKeys,

ObjectPrototypeHasOwnProperty,

RangeError,

ReflectApply,

RegExpPrototypeExec,

SafeArrayIterator,

SafeMap,

SafeWeakMap,

String,

StringPrototypeEndsWith,

StringPrototypeIncludes,

StringPrototypeIndexOf,

StringPrototypeSlice,

StringPrototypeSplit,

StringPrototypeStartsWith,

StringPrototypeToLowerCase,

Symbol,

SymbolFor,

SyntaxError,

TypeError,

URIError,

} = primordials;

const kIsNodeError = Symbol('kIsNodeError');

const isWindows = process.platform === 'win32';

const messages = new SafeMap();

const codes = {};

const classRegExp = /^[A-Z][a-zA-Z0-9]*$/;

// Sorted by a rough estimate on most frequently used entries.

const kTypes = [

'string',

'function',

'number',

'object',

// Accept 'Function' and 'Object' as alternative to the lower cased version.

'Function',

'Object',

'boolean',

'bigint',

'symbol',

];

const MainContextError = Error;

const overrideStackTrace = new SafeWeakMap();

let internalPrepareStackTrace = defaultPrepareStackTrace;

/**

* The default implementation of `Error.prepareStackTrace` with simple

* concatenation of stack frames.

* Read more about `Error.prepareStackTrace` at https://v8.dev/docs/stack-trace-api#customizing-stack-traces.

*/

function defaultPrepareStackTrace(error, trace) {

// 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 ')}`;

}

function setInternalPrepareStackTrace(callback) {

internalPrepareStackTrace = callback;

}

/**

* Every realm has its own prepareStackTraceCallback. When `error.stack` is

* accessed, if the error is created in a shadow realm, the shadow realm's

* prepareStackTraceCallback is invoked. Otherwise, the principal realm's

* prepareStackTraceCallback is invoked. Note that accessing `error.stack`

* of error objects created in a VM Context will always invoke the

* prepareStackTraceCallback of the principal realm.

* @param {object} globalThis The global object of the realm that the error was

* created in. When the error object is created in a VM Context, this is the

* global object of that VM Context.

* @param {object} error The error object.

* @param {CallSite[]} trace An array of CallSite objects, read more at https://v8.dev/docs/stack-trace-api#customizing-stack-traces.

* @returns {string}

*/

function prepareStackTraceCallback(globalThis, error, trace) {

// 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);

}

// 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);

}

// If the Error.prepareStackTrace was not a function, fallback to the

// internal implementation.

return internalPrepareStackTrace(error, trace);

}

/**

* The default Error.prepareStackTrace implementation.

*/

function ErrorPrepareStackTrace(error, trace) {

return internalPrepareStackTrace(error, trace);

}

const aggregateTwoErrors = (innerError, outerError) => {

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;

};

class NodeAggregateError extends AggregateError {

constructor(errors, message) {

super(new SafeArrayIterator(errors), message);

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

}

get [kIsNodeError]() {

return true;

}

get ['constructor']() {

return AggregateError;

}

}

const assert = require('internal/assert');

// Lazily loaded

let util;

let internalUtil = null;

function lazyInternalUtil() {

internalUtil ??= require('internal/util');

return internalUtil;

}

let internalUtilInspect = null;

function lazyInternalUtilInspect() {

internalUtilInspect ??= require('internal/util/inspect');

return internalUtilInspect;

}

let utilColors;

function lazyUtilColors() {

utilColors ??= require('internal/util/colors');

return utilColors;

}

let buffer;

function lazyBuffer() {

buffer ??= require('buffer').Buffer;

return buffer;

}

function isErrorStackTraceLimitWritable() {

// 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;

}

function inspectWithNoCustomRetry(obj, options) {

const utilInspect = lazyInternalUtilInspect();

try {

return utilInspect.inspect(obj, options);

} catch {

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

}

}

// A specialized Error that includes an additional info property with

// additional information about the error condition.

// It has the properties present in a UVException but with a custom error

// message followed by the uv error code and uv error message.

// It also has its own error code with the original uv error context put into

// `err.info`.

// The context passed into this error must have .code, .syscall and .message,

// and may have .path and .dest.

class SystemError extends Error {

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,

});

}

}

function makeSystemErrorWithCode(key) {

return class NodeError extends SystemError {

constructor(ctx) {

super(key, ctx);

}

};

}

// This is a special error type that is only used for the E function.

class HideStackFramesError extends Error {

}

function makeNodeErrorForHideStackFrame(Base, clazz) {

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;

}

function makeNodeErrorWithCode(Base, key) {

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;

}

}

}

/**

* This function removes unnecessary frames from Node.js core errors.

* @template {(...args: unknown[]) => unknown} T

* @param {T} fn

* @returns {T}

*/

function hideStackFrames(fn) {

function wrappedFn(...args) {

try {

return ReflectApply(fn, this, args);

} catch (error) {

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

throw error;

}

}

wrappedFn.withoutStackTrace = fn;

return wrappedFn;

}

// Utility function for registering the error codes. Only used here. Exported

// *only* to allow for testing.

function E(sym, val, def, ...otherClasses) {

// 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;

}

function getExpectedArgumentLength(msg) {

let expectedLength = 0;

const regex = /%[dfijoOs]/g;

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

return expectedLength;

}

function getMessage(key, args, self) {

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);

}

let uvBinding;

function lazyUv() {

uvBinding ??= internalBinding('uv');

return uvBinding;

}

const uvUnmappedError = ['UNKNOWN', 'unknown error'];

function uvErrmapGet(name) {

uvBinding = lazyUv();

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

return MapPrototypeGet(uvBinding.errmap, name);

}

/**

* This creates an error compatible with errors produced in the C++

* function UVException using a context object with data assembled in C++.

* The goal is to migrate them to ERR_* errors later when compatibility is

* not a concern.

*/

class UVException extends Error {

/**

* @param {object} ctx

*/

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;

}

}

/**

* This creates an error compatible with errors produced in the C++

* This function should replace the deprecated

* `exceptionWithHostPort()` function.

*/

class UVExceptionWithHostPort extends Error {

/**

* @param {number} err - A libuv error number

* @param {string} syscall

* @param {string} address

* @param {number} [port]

*/

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;

}

}

/**

* This used to be util._errnoException().

*/

class ErrnoException extends Error {

/**

* @param {number} err - A libuv error number

* @param {string} syscall

* @param {string} [original] err

*/

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;

}

}

/**

* Deprecated, new Error is `UVExceptionWithHostPort()`

* New function added the error description directly

* from C++. this method for backwards compatibility

* @param {number} err - A libuv error number

* @param {string} syscall

* @param {string} address

* @param {number} [port]

* @param {string} [additional]

* @returns {Error}

*/

class ExceptionWithHostPort extends 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;

}

}

class DNSException extends Error {

/**

* @param {number|string} code - A libuv error number or a c-ares error code

* @param {string} syscall

* @param {string} [hostname]

*/

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;

}

}

class ConnResetException extends Error {

constructor(msg) {

super(msg);

this.code = 'ECONNRESET';

}

get ['constructor']() {

return Error;

}

}

let maxStack_ErrorName;

let maxStack_ErrorMessage;

/**

* Returns true if `err.name` and `err.message` are equal to engine-specific

* values indicating max call stack size has been exceeded.

* "Maximum call stack size exceeded" in V8.

* @param {Error} err

* @returns {boolean}

*/

function isStackOverflowError(err) {

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;

}

// Only use this for integers! Decimal numbers do not work with this function.

function addNumericalSeparator(val) {

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}`;

}

// Used to enhance the stack that will be picked up by the inspector

const kEnhanceStackBeforeInspector = Symbol('kEnhanceStackBeforeInspector');

// These are supposed to be called only on fatal exceptions before

// the process exits.

const fatalExceptionStackEnhancers = {

beforeInspector(error) {

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;

},

afterInspector(error) {

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;

}

},

};

const {

privateSymbols: {

arrow_message_private_symbol,

},

} = internalBinding('util');

// Ensures the printed error line is from user code.

function setArrowMessage(err, arrowMessage) {

err[arrow_message_private_symbol] = arrowMessage;

}

// Hide stack lines before the first user code line.

function hideInternalStackFrames(error) {

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 ');

});

}

// Node uses an AbortError that isn't exactly the same as the DOMException

// to make usage of the error in userland and readable-stream easier.

// It is a regular error with `.code` and `.name`.

class AbortError extends Error {

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';

}

}

/**

* This creates a generic Node.js error.

* @param {string} message The error message.

* @param {object} errorProperties Object with additional properties to be added to the error.

* @returns {Error}

*/

const genericNodeError = hideStackFrames(function genericNodeError(message, errorProperties) {

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

const err = new Error(message);

ObjectAssign(err, errorProperties);

return err;

});

/**

* Determine the specific type of a value for type-mismatch errors.

* @param {*} value

* @returns {string}

*/

function determineSpecificType(value) {

if (value === null) {

return 'null';

} else if (value === undefined) {

return 'undefined';

}

const type = typeof value;