invokeOnCompletion

abstract fun invokeOnCompletion(handler: (Throwable?) -> Unit): DisposableHandle

注册一个在任务完成时(正常结束、被取消或失败)调用的回调函数。

这是 join() 的非阻塞替代方案,推荐在脚本中使用以避免阻塞线程。

Return

一个 DisposableHandle,可用于在不再需要时调用 dispose() 来移除该回调。

Parameters

handler

一个接收 Throwable? 类型参数的函数。 如果任务成功完成,参数为 null;否则,参数为导致失败或取消的异常。