debugTrace method

void debugTrace([
  1. String? label,
  2. int traceCount = 5
])

Captures the current stack trace and assigns an optional label to this tether.

  • label: An optional identifier for this tether.
  • traceCount: The number of call stack frames to retain (default: 5).

Ensures:

  • In debug mode, tags this tether and captures its creation call stack.
  • In release mode, executes as a no-op with zero runtime overhead.

Implementation

void debugTrace([String? label, int traceCount = 5]) => _captureDebugTrace(this, label, traceCount);