Log#
Engine logging facility — file sink by default, broadcast
Stream once a subscriber installs the bridge.
Upstream: YSE::log.
Log#
class Log
Engine logging facility.
- Two ways to consume log output:
Default file sink — controlled via [logfile] and [level].
The [messages] broadcast stream — install once and listen from any Dart code. Replaces the file sink for the duration of the subscription.
Logging is only active between System().init() and System().close().
Static accessors#
static Log get instance
Borrowed singleton accessor.
Properties#
LogLevel get level
set level(LogLevel value)
Current log-level filter. Messages above the chosen level are dropped.
String get logfile
set logfile(String path)
Path of the default log file (defaults to YSElog.txt in the process working directory). Has no effect after [messages] has been subscribed.
Stream<String> get messages
Broadcast stream of log messages from the engine.
Subscribing replaces the default file sink with an in-process callback that forwards every message into the stream. The first subscription installs the bridge; subsequent subscribers share the same stream.
Cancel the last subscription to release the callback. Callbacks run on whichever thread emitted the log message — NativeCallable.listener posts them back to this isolate via a port, so Dart code only ever sees them serialised in the isolate’s event queue. Messages still queued when the last subscription is cancelled are not delivered, but their native strings are still released.
Methods#
void sendMessage(String message)
Send an application-level message to the YSE log. Emitted at error-level so it survives filters set above [LogLevel.debug].