Источник времени тестирования

kotlin-stdlib / kotlin.time / Источник времени тестирования

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

@ExperimentalTime class TestTimeSource : 
    AbstractLongTimeSource

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

Текущее значение чтения можно увеличить на указанную длительность с помощью оператора plusAssign:

val timeSource = TestTimeSource()
timeSource += 10.seconds

Примечание к реализации: текущее значение чтения хранится как целое число Long в наносекундах, что позволяет представлять диапазон времени примерно ±292 года. В случае переполнения значения чтения в результате операции plusAssign выбрасывается исключение IllegalStateException.

Конструкторы

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

<init>

TestTimeSource()

Функции

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

plusAssign

Увеличивает текущее значение чтения этого источника времени на указанную длительность.

operator fun plusAssign(duration: Duration)

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

read

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

fun read(): Long

Расширяющие функции

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

measureTime

Выполняет заданную функцию block и возвращает длительность прошедшего интервала времени.

fun TimeSource.measureTime(block: () -> Unit): Duration

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

measureTimedValue

Выполняет заданный блок и возвращает экземпляр класса TimedValue, содержащий результат выполнения функции и длительность прошедшего интервала времени.

fun <T> TimeSource.measureTimedValue(
    block: () -> T
): TimedValue<T>

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