Реализовать удобный и понятный API для ожидания появления View или его состояния about kaspresso HOT 4 CLOSED

@matzuk @eakurnikov Давайте обсудим

from kaspresso.

@RuslanMingaliev предлагаю еще раз обсудить

from kaspresso.

@almaz010891, привет!

Выделил из issue две проблемы и предложения их решения:

1. Нет механизма, который бы позволил дождаться момента, когда кнопка появится в иерархии и выполнить с ней какое-либо действие
2. Нет механизма, который бы позволил дождаться определенного состояния кнопки и выполнить с ней действие.

Обе проблемы можно решить, используя механизм flakySafely. Например,

@Test
fun sample() = run {
    MainActivityScreen {
        flakySafely(timeoutMs = 60_000, intervalMs = 500, allowedExceptions(...)) {
            moreBtn {
                isVisible()
                isEnabled()
                click()
                withText(...)
            }
        }
    }
}

метод flakySafely принимает в себя (опционально) следующие параметры:
timeoutMs - максимальное время для выполнения действия
intervalMs - промежуток времени между выполнением действия
allowedException - список разрешенных исключений, которые будут подавляться при выполнении действия и перезапускать его через интервал.

Таким образом, в примере, который я привел выше, будет пытаться выполниться проверка на видимость кнопки, затем на её доступность (enabled), и когда оба условия выполнятся, произойдет клик на кнопку и проверка withText(). То есть этот код идентичен примеру из issue. withText можно вынести в отдельный блок flakySafely, если не нужно при фейле заново проверять на видимость, доступность и делать клик. Ну и если нужного исключения нет в списке стандартных исключений (a ViewNotFoundException там нет), то надо его добавить в allowedExceptions.

Если не очень удобно делать такую проверку в тесте, и надо унести в Screen, в котором нет BaseTestContext, то можно сделать так:

object MainActivityScreen {
    val moreBtn = KButton { withId(R.id.btn_more) }

    fun BaseTestContext.waitForButtonVisibleState(timeoutMs: Long) {
        flakySafely(timeoutMs = timeoutMs) {
            moreBtn.isVisible()
        } 
    }
} 

Ну и вызывать в тесте таким образом:

@Test
fun sample() = run {
    MainActivityScreen {
        waitForButtonVisibleState(timeoutMs = 5_000) 
        moreBtn.click()
    }
}

Согласен, что по названию метода flakySafely может быть не очевидно, как он на самом деле работает. @almaz010891, @matzuk, предлагайте названия, можем переименовать, а flakySafely оставить для обратной совместимости и сделать deprecated

from kaspresso.

Пока закрываю issue. @almaz010891 переоткрой, если ещё остались вопросы, обсудим. Можно даже созвониться.

from kaspresso.