traceBuffer property

LogBuffer? get traceBuffer

Returns a buffer for building multi-line trace-level logs.

Intentions: Allows accumulating multiple lines before logging to ensure atomic output, useful for complex trace messages. The buffer is null if logging is disabled.

How to use:

  • Get the buffer: final buf = logger.traceBuffer;
  • Write lines: buf?.writeln('Line 1'); buf?.writeln('Line 2');
  • Sink to log: buf?.sink();

Example: logger.traceBuffer?..writeln('Trace start')..sink();

Implementation

LogBuffer? get traceBuffer =>
    enabled ? LogBuffer.checkout(this, LogLevel.trace) : null;