copyForStackTraceRecovery

Версия Kotlin: 2.4

abstract fun copyForStackTraceRecovery(): T?

Создаёт копию this для восстановления трассировки стека.

Для упрощения отладки рекомендуется использовать исходное исключение в качестве причины результирующего исключения. Трассировка стека скопированного исключения будет перезаписана механизмом восстановления трассировки стека с помощью вызова Throwable.setStackTrace.

Исключение может отказаться от копирования, вернув null из этой функции.

Подавленные исключения исходного исключения следует оставлять без копирования, чтобы избежать циклических исключений.

Эта функция может создать копию с изменённым сообщением, но учтите, что копия впоследствии также может быть восстановлена, поэтому код изменения сообщения должен корректно обрабатывать эту ситуацию (например, также сохраняя исходное сообщение и проверяя его), чтобы сформировать понятный человеку результат.