Skip to main content

Log

Functions

getParentFunctionDescription

getParentFunctionDescription(this, levels?): string | undefined

Helper function to get the name and the line number of the current calling function.

For this function to work properly, the "--luadebug" flag must be enabled. Otherwise, it will always return undefined.

Parameters

NameTypeDefault valueDescription
thisvoidundefined-
levelsnumber3Optional. The amount of levels to look backwards in the call stack. Default is 3 (because the first level is this function, the second level is the calling function, and the third level is the parent of the calling function).

Returns

string | undefined

Defined in

packages/isaacscript-common/src/functions/log.ts:13


log

log(this, msg, includeParentFunction?): void

Helper function to avoid typing out Isaac.DebugString().

If you have the "--luadebug" launch flag turned on, then this function will also prepend the function name and the line number before the string, like this:

[INFO] - Lua Debug: saveToDisk:42494 - The save data manager wrote data to the "save#.dat" file.

Subsequently, it is recommended that you turn on the "--luadebug" launch flag when developing your mod so that debugging becomes a little bit easier.

Parameters

NameTypeDefault valueDescription
thisvoidundefined-
msgstring | numberundefinedThe message to log.
includeParentFunctionbooleantrueOptional. Whether to prefix the message with the function name and line number, as shown in the above example. Default is true.

Returns

void

Defined in

packages/isaacscript-common/src/functions/log.ts:56


logAndPrint

logAndPrint(msg): void

Helper function to log a message to the "log.txt" file and to print it to the screen at the same time.

Parameters

NameType
msgstring

Returns

void

Defined in

packages/isaacscript-common/src/functions/log.ts:79


logError

logError(this, msg): void

Helper function to log an error message and also print it to the console for better visibility.

This is useful in situations where using the error function would be dangerous (since it prevents all of the subsequent code in the callback from running).

Parameters

NameType
thisvoid
msgstring

Returns

void

Defined in

packages/isaacscript-common/src/functions/log.ts:90