toString method

@override String toString()

A string representation of this object.

Some classes have a default textual representation, often paired with a static parse function (like int.parse). These classes will provide the textual representation as their string representation.

Other classes have no meaningful textual representation that a program will care about. Such classes will typically override toString to provide useful information when inspecting the object, mainly for debugging or logging.

Implementation

@override
@pragma('vm:prefer-inline')
String toString() {
  try {
    final encoder = const JsonEncoder.withIndent('  ');
    return encoder.convert(toJson());
  } catch (_) {
    // Defensive: on dart2wasm the underlying `Trace.frames` parser can
    // return frames whose `.toString()` itself throws (the WASM-native
    // stack format isn't fully understood by `package:stack_trace`).
    // Fall back to a minimal representation so logging/asserting on an
    // `Err` never crashes the host process — life-critical callers must
    // be able to surface the error, not vanish in a runtime crash.
    return 'Err<$T>(${_safeToString(value)})';
  }
}