Skip to content

API Reference / @gtkx/runtime / onLog

Function: onLog() ​

onLog(listener): LogSubscription

Defined in: packages/runtime/src/logging.ts:67

Subscribes to GLib logs from every thread. The listener receives the level, domain, and message. Records reach JavaScript asynchronously; yield to the event loop before checking collected logs. Listener errors are thrown after every listener receives the record; multiple errors become an AggregateError.

Fatal logs, including levels made fatal by logSetAlwaysFatal, abort before delivery and never reach the listener. Unsubscribing stops new records but leaves already queued deliveries intact.

Parameters ​

listener ​

LogListener

Returns ​

LogSubscription