Исключения

@Target([AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY_GETTER, AnnotationTarget.PROPERTY_SETTER, AnnotationTarget.CONSTRUCTOR]) annotation class Throws

typealias Throws = Throws

@Target([AnnotationTarget.FUNCTION, AnnotationTarget.CONSTRUCTOR]) annotation class Throws

Для JVM

Эта аннотация указывает, какие исключения должны быть объявлены функцией при компиляции в метод JVM.

Пример:

@Throws(IOException::class)
fun readFile(name: String): String {...}

будет преобразовано в

String readFile(String name) throws IOException {...}

Для Common

Эта аннотация указывает, какие исключения должны быть объявлены функцией при компиляции в платформенный метод в Kotlin/JVM и Kotlin/Native.

Для Native

Эта аннотация указывает, какие исключения должны быть объявлены функцией при компиляции в платформенный метод.

При компиляции в Objective-C/Swift фреймворк, функции, имеющие или наследующие эту аннотацию, отображаются как методы, генерирующие NSError* в Objective-C и как методы, генерирующие throws в Swift. Представления для suspend функций всегда имеют параметр NSError*/Error в обработчике завершения.

Когда функция Kotlin, вызываемая из Swift/Objective-C кода, выбрасывает исключение, являющееся экземпляром одного из exceptionClasses или его подклассов, оно распространяется как NSError. Другие исключения Kotlin, достигающие Swift/Objective-C, считаются необработанными и приводят к завершению программы.

Примечание: suspend функции без @Throws распространяют только kotlin.coroutines.cancellation.CancellationException как NSError. Функции без suspend без @Throws вообще не распространяют исключения Kotlin.