Console.hx is a haxe logging utility for easy rich output in both native and browser consoles via a familiar HTML-like tag syntax. Supports haxe 3 and haxe 4.

For example:

Console.log('<b>Don’t</> <red,u>Panic.</>');

This will print in your console something like:

(Depending on your console color settings). This will also work in a browser console when targeting the web. All console output can be disable by passing -D no_console.

Installing

haxelib install console.hx

And add -lib Console.hx when compiling your haxe code

API

Console.log(...args)

log() prints all arguments to stdout. String type arguments will have <tags> processed by the formatter. The log prefix can be configured by setting Console.logPrefix.

Example

Console.log('<b>Hello</>', '<i>world</i>')

> Hello world

Console.warn(...args)

warn() prints all arguments to stderr. String type arguments will have <tags> processed by the formatter. The warn prefix can be configured by setting Console.warnPrefix.

Console.error(...args)

error() prints all arguments to stderr. String type arguments will have <tags> processed by the formatter. By default, errors will be printed in red, the error prefix (including formatting) configured by setting Console.errorPrefix.

Console.success(...args)

success() prints all arguments to stdout. String type arguments will have <tags> processed by the formatter. The success prefix can be configured by setting Console.successPrefix.

Console.debug(...args)

debug() output will only appear in the console when the haxe -debug flag is set and output is prefixed with the line number like trace(). String type arguments will have <tags> processed by the formatter. The debug prefix can be configured by setting Console.debugPrefix.

Example

Console.debug('hello', 'world')

> Main:5: hello world

Console.examine(...args)

examine() prints variable names alongside their values

Example

var x = 31.1;
var y = 65.3;
Console.examine(x, y);

> x: 32.1 y: 65.3

Console.printlnFormatted( string: String, outputStream: Log | Warn | Error | Debug = Log)

Print a line to the console after processing <tags> but without a log prefix

Console.println( string: String, outputStream: Log | Warn | Error | Debug = Log)

Print a line directly to the console without processing formatting <tags>.

Formatting

• Apply formatting with HTML-like tags it: <b>bold</b> or <i>italic</i>
• Close the last tag with shorthand </>: <b>bold</> not bold
• A double-closing tag like <//> will clear all active formatting
• Formatting can be combined into a single tag: <b,i>bold and italic</>
• Hex colors can be used (including CSS shorthand form), for example
  • <#FF0000>Red Text</>
  • <bg#F00>Red Background</>
• Whitespace is not allowed in tags, so <b > would be ignored and printed as-is
• Tags can be escaped with a leading backslash: \<b> would be printed as <b>
• CSS can be used when targeting web browsers: for example: <{color: red; font-size: 20px}>Inline CSS</>. These will have no affect on native consoles

Available Tags

Supported Targets

Formatting should work on mac, linux and browser consoles for all targets, however for built-in Windows consoles like Command Prompt and PowerShell, only Neko and C++ will produce colored output (assuming you're running a fairly recent build of Windows 10)