runtime-core/io.matthewnelson.kmp.tor.runtime.core/EnqueuedJob/onError

onError

protected fun onError(cause: Throwable, withLock: ItBlock<Throwable>?): Boolean(source)

Sets the job state to State.Error and invokes OnFailure with provided cause. Does nothing if the job is completed or completing.

withLock will be invoked with the final Throwable for which onFailure will be called with. It may not be the same as cause, depending on the executionPolicy set.

Implementations must not call invokeOnCompletion from within the withLock lambda. It will result in a deadlock.

Return

true if it executed successfully, false if the job is completed or completing.