Clone this repo:
  1. 56d4fde minor cleanups (#50) by Phil Quitslund · 2 weeks ago master
  2. 335d44e Only test one browser by Kevin Moore · 3 weeks ago
  3. 332f707 Enable a number of new lints by Kevin Moore · 3 weeks ago
  4. feefafa dartfmt --fix, update min SDK to 2.0.0 by Kevin Moore · 3 weeks ago
  5. 89e72e2 Merge pull request #48 from dart-lang/pub-shield by Phil Quitslund · 3 weeks ago

Build Status Pub

Initializing

By default, the logging package does not do anything useful with the log messages. You must configure the logging level and add a handler for the log messages.

Here is a simple logging configuration that logs all messages via print.

Logger.root.level = Level.ALL;
Logger.root.onRecord.listen((record) {
  print('${record.level.name}: ${record.time}: ${record.message}');
});

First, set the root Level. All messages at or above the level are sent to the onRecord stream.

Then, listen on the onRecord stream for LogRecord events. The LogRecord class has various properties for the message, error, logger name, and more.

Logging messages

Create a Logger with a unique name to easily identify the source of the log messages.

final log = Logger('MyClassName');

Here is an example of logging a debug message and an error:

var future = doSomethingAsync().then((result) {
  log.fine('Got the result: $result');
  processResult(result);
}).catchError((e, stackTrace) => log.severe('Oh noes!', e, stackTrace));

When logging more complex messages, you can pass a closure instead that will be evaluated only if the message is actually logged:

log.fine(() => [1, 2, 3, 4, 5].map((e) => e * 4).join("-"));

See the Logger class for the different logging methods.