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
Name | Type | Default value | Description |
---|---|---|---|
this | void | undefined | - |
levels | number | 3 | Optional. 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
Name | Type | Default value | Description |
---|---|---|---|
this | void | undefined | - |
msg | string | number | undefined | The message to log. |
includeParentFunction | boolean | true | Optional. 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
Name | Type |
---|---|
msg | string |
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
Name | Type |
---|---|
this | void |
msg | string |
Returns
void