runtime-core/io.matthewnelson.kmp.tor.runtime.core/UncaughtException/SuppressedHandler

SuppressedHandler

class SuppressedHandler : UncaughtException.Handler

A special Handler utilized within Handler.withSuppression lambda which propagates all exceptions caught by Handler.tryCatch into a single, root exception (the first thrown), with all subsequent exceptions added via Throwable.addSuppressed.

Properties

isActive

@get:JvmName(name = "isActive")

val isActive: Boolean

If the Handler.withSuppression block has completed.

Functions

invoke

open operator override fun invoke(it: UncaughtException)

tryCatch

@JvmStatic

fun UncaughtException.Handler?.tryCatch(context: Any, block: ItBlock<Unit>)

Helper for wrapping external function calls in order to redirect any uncaught exceptions.

withSuppression

@JvmStatic

fun <T> UncaughtException.Handler?.withSuppression(block: UncaughtException.SuppressedHandler.() -> T): T

Wraps an existing handler with suppression such that any invocation of tryCatch within block lambda is combined into a single UncaughtException, which is then propagated to the current handler (if there even was an UncaughtException).