Объявления уровня пакета

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

Типы

Требования к платформе и версии: Native (1.3)


@Target(allowedTargets = [AnnotationTarget.FUNCTION])
annotation class AfterClass

Обозначает функцию, которая будет выполнена после набора тестов. Не поддерживается в Kotlin/Common.

AfterTest

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)


@Target(allowedTargets = [AnnotationTarget.FUNCTION])
expect annotation class AfterTest

Обозначает функцию, вызываемую после каждого теста.

Требования к платформе и версии: jvm-JUnit (1.0)

actual typealias AfterTest = After

typealias AfterTest = After

Обозначает функцию, вызываемую после каждого теста.

Требования к платформе и версии: jvm-JUnit5 (1.0)

actual typealias AfterTest = AfterEach

typealias AfterTest = AfterEach

Обозначает функцию, вызываемую после каждого теста.

Требования к платформе и версии: jvm-TestNG (1.0)

actual typealias AfterTest = AfterMethod

typealias AfterTest = AfterMethod

Обозначает функцию, вызываемую после каждого теста.

Asserter

Требования к платформе и версии: Common (1.0)

interface Asserter

Абстрагирует логику выполнения проверок. Конкретные реализации Asserter могут использовать средства проверки JUnit или TestNG.

AsserterContributor

Требования к платформе и версии: Common (1.0)

interface AsserterContributor

Проверяет применимость и предоставляет экземпляр Asserter

AssertionResult

Требования к платформе и версии: JS (1.1)

external interface AssertionResult

Описывает результат выполнения проверки.

Требования к платформе и версии: Wasm-JS (1.8), Wasm-WASI (1.8)

interface AssertionResult

Описывает результат выполнения проверки.

BeforeClass

Требования к платформе и версии: Native (1.3)


@Target(allowedTargets = [AnnotationTarget.FUNCTION])
annotation class BeforeClass

Обозначает функцию, которая будет выполнена перед набором тестов. Не поддерживается в Kotlin/Common.

BeforeTest

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)


@Target(allowedTargets = [AnnotationTarget.FUNCTION])
expect annotation class BeforeTest

Обозначает функцию, вызываемую перед каждым тестом.

Требования к платформе и версии: jvm-JUnit (1.0)

actual typealias BeforeTest = Before

typealias BeforeTest = Before

Обозначает функцию, вызываемую перед каждым тестом.

Требования к платформе и версии: jvm-JUnit5 (1.0)

actual typealias BeforeTest = BeforeEach

typealias BeforeTest = BeforeEach

Обозначает функцию, вызываемую перед каждым тестом.

Требования к платформе и версии: jvm-TestNG (1.0)

actual typealias BeforeTest = BeforeMethod

typealias BeforeTest = BeforeMethod

Обозначает функцию, вызываемую перед каждым тестом.

DefaultAsserter

Требования к платформе и версии: Common (1.0)

object DefaultAsserter : Asserter

Реализация Asserter по умолчанию, позволяющая избежать зависимости от JUnit или TestNG.

ExperimentalKotlinTestApi

Требования к платформе и версии: Common (2.4)



@RequiresOptIn(level = RequiresOptIn.Level.ERROR)


@Target(allowedTargets = [AnnotationTarget.CLASS, AnnotationTarget.ANNOTATION_CLASS, AnnotationTarget.PROPERTY, AnnotationTarget.FIELD, AnnotationTarget.LOCAL_VARIABLE, AnnotationTarget.VALUE_PARAMETER, AnnotationTarget.CONSTRUCTOR, AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY_GETTER, AnnotationTarget.PROPERTY_SETTER, AnnotationTarget.TYPEALIAS])

annotation class ExperimentalKotlinTestApi

Эта аннотация обозначает экспериментальный API kotlin.test.

FrameworkAdapter

Требования к платформе и версии: JS (1.1)

external interface FrameworkAdapter

Служит связующим звеном с тестовым фреймворком.

Требования к платформе и версии: Wasm-JS (1.8), Wasm-WASI (1.8)

interface FrameworkAdapter

Служит связующим звеном с тестовым фреймворком.

Ignore

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)


@Target(allowedTargets = [AnnotationTarget.CLASS, AnnotationTarget.FUNCTION])
expect annotation class Ignore

Обозначает тест или набор тестов как пропущенный.

Требования к платформе и версии: jvm-JUnit (1.0)

actual typealias Ignore = org.junit.Ignore

typealias Ignore = org.junit.Ignore

Обозначает тест или набор тестов как пропущенный.

Требования к платформе и версии: jvm-JUnit5 (1.0)

actual typealias Ignore = Disabled

typealias Ignore = Disabled

Обозначает тест или набор тестов как пропущенный.

Требования к платформе и версии: jvm-TestNG (1.0)

actual typealias Ignore = org.testng.annotations.Ignore

typealias Ignore = org.testng.annotations.Ignore

Обозначает тест или набор тестов как пропущенный.

KotlinTestNamespace

Требования к платформе и версии: JS (1.1)

external interface KotlinTestNamespace

Test

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)


@Target(allowedTargets = [AnnotationTarget.FUNCTION])
expect annotation class Test

Обозначает функцию как тест.

Требования к платформе и версии: jvm-JUnit (1.0)

actual typealias Test = org.junit.Test

typealias Test = org.junit.Test

Обозначает функцию как тест.

Требования к платформе и версии: jvm-JUnit5 (1.0)

actual typealias Test = org.junit.jupiter.api.Test

typealias Test = org.junit.jupiter.api.Test

Обозначает функцию как тест.

Требования к платформе и версии: jvm-TestNG (1.0)

actual typealias Test = org.testng.annotations.Test

typealias Test = org.testng.annotations.Test

Обозначает функцию как тест.

Свойства

asserter

Требования к платформе и версии: Common (1.0)

val asserter: Asserter

Текущий адаптер, предоставляющий реализации проверок

kotlinTestNamespace

Требования к платформе и версии: JS (1.1)

external val kotlinTestNamespace: KotlinTestNamespace

Функции

assertContains

Требования к платформе и версии: Common (2.4)


@ExperimentalKotlinTestApi
fun <T> assertContains(array: Array<T>, element: T, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(array: BooleanArray, element: Boolean, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(array: ByteArray, element: Byte, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(array: CharArray, element: Char, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(array: IntArray, element: Int, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(array: LongArray, element: Long, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(array: ShortArray, element: Short, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(array: UByteArray, element: UByte, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(array: UIntArray, element: UInt, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(array: ULongArray, element: ULong, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(array: UShortArray, element: UShort, lazyMessage: () -> String)

Проверяет, что array содержит указанный element; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun <T> assertContains(array: Array<T>, element: T, message: String? = null)

fun assertContains(array: BooleanArray, element: Boolean, message: String? = null)

fun assertContains(array: ByteArray, element: Byte, message: String? = null)

fun assertContains(array: CharArray, element: Char, message: String? = null)

fun assertContains(array: IntArray, element: Int, message: String? = null)

fun assertContains(array: LongArray, element: Long, message: String? = null)

fun assertContains(array: ShortArray, element: Short, message: String? = null)

fun assertContains(array: UByteArray, element: UByte, message: String? = null)

fun assertContains(array: UIntArray, element: UInt, message: String? = null)

fun assertContains(array: ULongArray, element: ULong, message: String? = null)

fun assertContains(array: UShortArray, element: UShort, message: String? = null)

Проверяет, что array содержит указанный element; можно указать необязательное message.


@ExperimentalKotlinTestApi
fun assertContains(charSequence: CharSequence, regex: Regex, lazyMessage: () -> String)

Проверяет, что charSequence содержит хотя бы одно совпадение с указанным регулярным выражением regex; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun assertContains(charSequence: CharSequence, regex: Regex, message: String? = null)

Проверяет, что charSequence содержит хотя бы одно совпадение с указанным регулярным выражением regex; можно указать необязательное message.


@ExperimentalKotlinTestApi
fun <T> assertContains(iterable: Iterable<T>, element: T, lazyMessage: () -> String)

Проверяет, что iterable содержит указанный element; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun <T> assertContains(iterable: Iterable<T>, element: T, message: String? = null)

Проверяет, что iterable содержит указанный element; можно указать необязательное message.


@ExperimentalKotlinTestApi
fun <K, V> assertContains(map: Map<K, V>, key: K, lazyMessage: () -> String)

Проверяет, что map содержит указанный key; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun <K, V> assertContains(map: Map<K, V>, key: K, message: String? = null)

Проверяет, что map содержит указанный key; можно указать необязательное message.


@ExperimentalKotlinTestApi
fun assertContains(range: CharRange, value: Char, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun <T : Comparable<T>> assertContains(range: ClosedRange<T>, value: T, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(range: IntRange, value: Int, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(range: LongRange, value: Long, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun <T : Comparable<T>> assertContains(range: OpenEndRange<T>, value: T, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(range: UIntRange, value: UInt, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContains(range: ULongRange, value: ULong, lazyMessage: () -> String)

Проверяет, что range содержит указанное value; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun assertContains(range: CharRange, value: Char, message: String? = null)

fun <T : Comparable<T>> assertContains(range: ClosedRange<T>, value: T, message: String? = null)

fun assertContains(range: IntRange, value: Int, message: String? = null)

fun assertContains(range: LongRange, value: Long, message: String? = null)

fun assertContains(range: UIntRange, value: UInt, message: String? = null)

fun assertContains(range: ULongRange, value: ULong, message: String? = null)

Проверяет, что range содержит указанное value; можно указать необязательное message.

fun <T : Comparable<T>> assertContains(range: OpenEndRange<T>, value: T, message: String? = null)

Проверяет, что range содержит указанное value; можно указать необязательное message.


@ExperimentalKotlinTestApi
fun <T> assertContains(sequence: Sequence<T>, element: T, lazyMessage: () -> String)

Проверяет, что sequence содержит указанный element; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun <T> assertContains(sequence: Sequence<T>, element: T, message: String? = null)

Проверяет, что sequence содержит указанный element; можно указать необязательное message.


@ExperimentalKotlinTestApi
fun assertContains(charSequence: CharSequence, char: Char, ignoreCase: Boolean = false, lazyMessage: () -> String)

Проверяет, что charSequence содержит указанный char; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun assertContains(charSequence: CharSequence, char: Char, ignoreCase: Boolean = false, message: String? = null)

Проверяет, что charSequence содержит указанный char; можно указать необязательное message.


@ExperimentalKotlinTestApi
fun assertContains(charSequence: CharSequence, other: CharSequence, ignoreCase: Boolean = false, lazyMessage: () -> String)

Проверяет, что charSequence содержит указанную символьную последовательность other в качестве подстроки; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun assertContains(charSequence: CharSequence, other: CharSequence, ignoreCase: Boolean = false, message: String? = null)

Проверяет, что charSequence содержит указанную символьную последовательность other в качестве подстроки; можно указать необязательное message.

assertContentEquals

Требования к платформе и версии: Common (2.4)


@ExperimentalKotlinTestApi
fun <T> assertContentEquals(expected: Array<T>?, actual: Array<T>?, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContentEquals(expected: BooleanArray?, actual: BooleanArray?, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContentEquals(expected: ByteArray?, actual: ByteArray?, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContentEquals(expected: CharArray?, actual: CharArray?, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContentEquals(expected: DoubleArray?, actual: DoubleArray?, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContentEquals(expected: FloatArray?, actual: FloatArray?, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContentEquals(expected: IntArray?, actual: IntArray?, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContentEquals(expected: LongArray?, actual: LongArray?, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContentEquals(expected: ShortArray?, actual: ShortArray?, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContentEquals(expected: UByteArray?, actual: UByteArray?, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContentEquals(expected: UIntArray?, actual: UIntArray?, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContentEquals(expected: ULongArray?, actual: ULongArray?, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertContentEquals(expected: UShortArray?, actual: UShortArray?, lazyMessage: () -> String)

Проверяет, что массив expected структурно равен массиву actual; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun <T> assertContentEquals(expected: Array<T>?, actual: Array<T>?, message: String? = null)

fun assertContentEquals(expected: BooleanArray?, actual: BooleanArray?, message: String? = null)

fun assertContentEquals(expected: ByteArray?, actual: ByteArray?, message: String? = null)

fun assertContentEquals(expected: CharArray?, actual: CharArray?, message: String? = null)

fun assertContentEquals(expected: DoubleArray?, actual: DoubleArray?, message: String? = null)

fun assertContentEquals(expected: FloatArray?, actual: FloatArray?, message: String? = null)

fun assertContentEquals(expected: IntArray?, actual: IntArray?, message: String? = null)

fun assertContentEquals(expected: LongArray?, actual: LongArray?, message: String? = null)

fun assertContentEquals(expected: ShortArray?, actual: ShortArray?, message: String? = null)

fun assertContentEquals(expected: UByteArray?, actual: UByteArray?, message: String? = null)

fun assertContentEquals(expected: UIntArray?, actual: UIntArray?, message: String? = null)

fun assertContentEquals(expected: ULongArray?, actual: ULongArray?, message: String? = null)

fun assertContentEquals(expected: UShortArray?, actual: UShortArray?, message: String? = null)

Проверяет, что массив expected структурно равен массиву actual; можно указать необязательное message.


@ExperimentalKotlinTestApi
fun <T> assertContentEquals(expected: Iterable<T>?, actual: Iterable<T>?, lazyMessage: () -> String)

Проверяет, что expected итерируемая последовательность структурно равна итерируемой последовательности actual; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun <T> assertContentEquals(expected: Iterable<T>?, actual: Iterable<T>?, message: String? = null)

Проверяет, что expected итерируемая последовательность структурно равна итерируемой последовательности actual; можно указать необязательное message.


@ExperimentalKotlinTestApi
fun <T> assertContentEquals(expected: Set<T>?, actual: Set<T>?, lazyMessage: () -> String)

fun <T> assertContentEquals(expected: Set<T>?, actual: Set<T>?, message: String? = null)


@ExperimentalKotlinTestApi
fun <T> assertContentEquals(expected: Sequence<T>?, actual: Sequence<T>?, lazyMessage: () -> String)

Проверяет, что последовательность expected структурно равна последовательности actual; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun <T> assertContentEquals(expected: Sequence<T>?, actual: Sequence<T>?, message: String? = null)

Проверяет, что последовательность expected структурно равна последовательности actual; можно указать необязательное message.

assertEquals

Требования к платформе и версии: Common (2.4)


@ExperimentalKotlinTestApi
fun <T> assertEquals(expected: T, actual: T, lazyMessage: () -> String)

Проверяет, что значение expected равно значению actual; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun <T> assertEquals(expected: T, actual: T, message: String? = null)

Проверяет, что значение expected равно значению actual; можно указать необязательное message.


@ExperimentalKotlinTestApi
fun assertEquals(expected: Double, actual: Double, absoluteTolerance: Double, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertEquals(expected: Float, actual: Float, absoluteTolerance: Float, lazyMessage: () -> String)

Проверяет, что разница между значениями actual и expected не превышает absoluteTolerance; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun assertEquals(expected: Double, actual: Double, absoluteTolerance: Double, message: String? = null)

fun assertEquals(expected: Float, actual: Float, absoluteTolerance: Float, message: String? = null)

Проверяет, что разница между значениями actual и expected не превышает absoluteTolerance; можно указать необязательное message.

assertFails

Требования к платформе и версии: Common (1.0)



@JvmName(name = "assertFailsAny")


@IgnorableReturnValue

inline fun assertFails(block: () -> Any?): Throwable

Проверяет, что указанная функция block завершается с ошибкой, выбрасывая исключение.



@JvmName(name = "assertFailsAny")


@IgnorableReturnValue

inline fun assertFails(message: String?, block: () -> Any?): Throwable

Проверяет, что указанная функция block завершается с ошибкой, выбрасывая исключение.

assertFailsWith

Требования к платформе и версии: Common (1.0)



@JvmName(name = "assertFailsWithAny")


@IgnorableReturnValue

inline fun <T : Throwable> assertFailsWith(message: String? = null, block: () -> Any?): T

Проверяет, что блок block завершается с ошибкой, выбрасывая исключение заданного типа T.



@JvmName(name = "assertFailsWithAny")


@IgnorableReturnValue

inline fun <T : Throwable> assertFailsWith(exceptionClass: KClass<T>, block: () -> Any?): T



@JvmName(name = "assertFailsWithAny")


@IgnorableReturnValue

inline fun <T : Throwable> assertFailsWith(exceptionClass: KClass<T>, message: String?, block: () -> Any?): T

Проверяет, что блок block завершается с ошибкой, выбрасывая исключение заданного типа exceptionClass.

assertFalse

Требования к платформе и версии: Common (2.4)


@ExperimentalKotlinTestApi
fun assertFalse(actual: Boolean, lazyMessage: () -> String)

Проверяет, что выражение actual равно false; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun assertFalse(actual: Boolean, message: String? = null)

Проверяет, что выражение равно false; можно указать необязательное message.


@JvmName(name = "assertFalseInline")
inline fun assertFalse(message: String? = null, block: () -> Boolean)

Проверяет, что указанный block возвращает false.

assertIs

Требования к платформе и версии: Common (2.4)



@ExperimentalKotlinTestApi


@IgnorableReturnValue

inline fun <T> assertIs(value: Any?, lazyMessage: () -> String): T

Проверяет, что value имеет тип T; в противном случае lambda lazyMessage формирует сообщение об ошибке.


@IgnorableReturnValue
inline fun <T> assertIs(value: Any?, message: String? = null): T

Проверяет, что value имеет тип T; можно указать необязательное message.

assertIsNot

Требования к платформе и версии: Common (2.4)


@ExperimentalKotlinTestApi
inline fun <T> assertIsNot(value: Any?, lazyMessage: () -> String)

Проверяет, что value не имеет тип T; в противном случае lambda lazyMessage формирует сообщение об ошибке.

inline fun <T> assertIsNot(value: Any?, message: String? = null)

Проверяет, что value не имеет тип T; можно указать необязательное message.

assertNotEquals

Требования к платформе и версии: Common (2.4)


@ExperimentalKotlinTestApi
fun <T> assertNotEquals(illegal: T, actual: T, lazyMessage: () -> String)

Проверяет, что значение actual не равно недопустимому значению; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun <T> assertNotEquals(illegal: T, actual: T, message: String? = null)

Проверяет, что значение actual не равно недопустимому значению; можно указать необязательное message.


@ExperimentalKotlinTestApi
fun assertNotEquals(illegal: Double, actual: Double, absoluteTolerance: Double, lazyMessage: () -> String)


@ExperimentalKotlinTestApi
fun assertNotEquals(illegal: Float, actual: Float, absoluteTolerance: Float, lazyMessage: () -> String)

Проверяет, что разница между значениями actual и illegal не входит в пределы absoluteTolerance; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun assertNotEquals(illegal: Double, actual: Double, absoluteTolerance: Double, message: String? = null)

fun assertNotEquals(illegal: Float, actual: Float, absoluteTolerance: Float, message: String? = null)

Проверяет, что разница между значениями actual и illegal не входит в пределы absoluteTolerance; можно указать необязательное message.

assertNotNull

Требования к платформе и версии: Common (1.0)


@IgnorableReturnValue
fun <T : Any> assertNotNull(actual: T?, message: String? = null): T

Проверяет, что значение actual не равно null; можно указать необязательное message.


@JvmName(name = "assertNotNullInline")
inline fun <T : Any, R> assertNotNull(actual: T?, message: String? = null, block: (T) -> R)

Проверяет, что значение actual не равно null; можно указать необязательное message и функцию block для обработки ненулевого значения.

assertNotSame

Требования к платформе и версии: Common (2.4)


@ExperimentalKotlinTestApi
fun <T> assertNotSame(illegal: T, actual: T, lazyMessage: () -> String)

Проверяет, что actual не является тем же экземпляром, что и illegal; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun <T> assertNotSame(illegal: T, actual: T, message: String? = null)

Проверяет, что actual не является тем же экземпляром, что и illegal; можно указать необязательное message.

assertNull

Требования к платформе и версии: Common (2.4)


@ExperimentalKotlinTestApi
fun assertNull(actual: Any?, lazyMessage: () -> String)

Проверяет, что значение actual равно null; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun assertNull(actual: Any?, message: String? = null)

Проверяет, что значение actual равно null; можно указать необязательное message.

assertSame

Требования к платформе и версии: Common (2.4)


@ExperimentalKotlinTestApi
fun <T> assertSame(expected: T, actual: T, lazyMessage: () -> String)

Проверяет, что expected является тем же экземпляром, что и actual; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun <T> assertSame(expected: T, actual: T, message: String? = null)

Проверяет, что expected является тем же экземпляром, что и actual; можно указать необязательное message.

assertTrue

Требования к платформе и версии: Common (2.4)


@ExperimentalKotlinTestApi
fun assertTrue(actual: Boolean, lazyMessage: () -> String)

Проверяет, что выражение actual равно true; в противном случае lambda lazyMessage формирует сообщение об ошибке.

fun assertTrue(actual: Boolean, message: String? = null)

Проверяет, что выражение равно true; можно указать необязательное message.


@JvmName(name = "assertTrueInline")
inline fun assertTrue(message: String? = null, block: () -> Boolean)

Проверяет, что указанный block возвращает true.

currentStackTrace

Требования к платформе и версии: JVM (1.0)

inline fun currentStackTrace(): Array<StackTraceElement>

Возвращает массив элементов трассировки стека, каждый из которых представляет один кадр стека. Первый элемент массива (если массив не пуст) представляет вершину стека — место, откуда была вызвана функция currentStackTrace.

expect

Требования к платформе и версии: Common (1.0)


@JvmName(name = "expectInline")
inline fun <T> expect(expected: T, block: () -> T)

Проверяет, что указанная функция block возвращает заданное значение expected.


@JvmName(name = "expectInline")
inline fun <T> expect(expected: T, message: String?, block: () -> T)

Проверяет, что указанная функция block возвращает заданное значение expected, и использует указанное message, если проверка завершается неудачно.

fail

Требования к платформе и версии: Common (1.0)

fun fail(message: String? = null): Nothing

Помечает тест как завершившийся неудачно, если выполнение доходит до этой точки; можно указать необязательное message.

fun fail(message: String? = null, cause: Throwable? = null): Nothing

Помечает тест как завершившийся неудачно, если выполнение доходит до этой точки; можно указать необязательное message и исключение cause.

todo

Требования к платформе и версии: Common (1.0), JS (1.1), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun todo(block: () -> Unit)

Принимает указанный block тестового кода и не выполняет его.

Требования к платформе и версии: JVM (1.0), Native (1.3)

actual inline fun todo(block: () -> Unit)

Принимает указанный block тестового кода и не выполняет его.

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-test/kotlin.test/index.html