detect (Vision)

You can detect text element using these functions.

Selector expression is accepted as argument.

The function returns VisionElement object.

Functions

function description
detect Finds the first element that matches the selector in current screen. Scrolling occurs within withScroll function.
detectWithScrollDown Finds the first element that matches the selector with scrolling down.
detectWithScrollUp Finds the first element that matches the selector with scrolling up.
detectWithScrollRight Finds the first element that matches the selector with scrolling right.
detectWithScrollLeft Finds the first element that matches the selector with scrolling left.
detectWithoutScroll Finds the first element that matches the selector without scrolling.

Key arguments

argument description
expression Selector expression
language AI-OCR language
last true: Finds the last element.
false: Finds the first element(default).

Sample code

Getting samples

Detect1.kt

(kotlin/tutorial/basic/Detect1.kt)

    @Test
    @Order(10)
    fun detect() {

        scenario {
            case(1) {
                action {
                    it.detect("Search settings")
                    output(it)

                    it.detect("Network & internet")
                    output(it)
                }
            }
        }
    }

    @Test
    @Order(20)
    fun detectWithScrollDown_detectWithScrollUp() {

        scenario {
            case(1) {
                action {
                    it.detectWithScrollDown("Tips & support")
                    output(it)
                }
            }
        }
    }

    @Test
    @Order(30)
    fun detect_patterns() {

        scenario {
            case(1) {
                action {
                    it.detect("Search settings")
                    output(it)

                    it.detect("*arch sett*")
                    output(it)

                    it.detect("Search*")
                    output(it)

                    it.detect("*settings")
                    output(it)

                    it.detect("Search*&&*settings")
                    output(it)
                }
            }
        }
    }

Link