log function

void log(
  1. Object? message, {
  2. LogLevel level = LogLevel.info,
  3. Object? error,
  4. StackTrace? stack,
})

Records message in the LogSink of the app whose handlers, timers or frames call it; elsewhere prints the record.

message is recorded as its text (Object.toString), at level, LogLevel.info by default, with error and its stack where given. Inside TwkApp.run the record goes to TwkApp.logs, so it does not land in the middle of a frame; twk logs shows it while the app serves its log (TwkApp.serveLogs).

try {
  int.parse('x');
} on FormatException catch (e, stack) {
  log('bad input', level: LogLevel.warning, error: e, stack: stack);
}

Implementation

void log(
  Object? message, {
  LogLevel level = LogLevel.info,
  Object? error,
  StackTrace? stack,
}) {
  final record = LogRecord(
    DateTime.now(),
    level,
    '$message',
    error: error,
    stack: stack,
  );
  final sink = Zone.current[logSinkKey] as LogSink?;
  if (sink != null) {
    sink.add(record);
  } else {
    Zone.current.print('$record');
  }
}