com.github.mvysny.kaributesting.v10.groovy.LocatorG.groovy Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of karibu-testing-v10-groovy Show documentation
Karibu Testing, support for browserless Vaadin testing in Kotlin
There is a newer version: 2.2.0
Show newest version
package com.github.mvysny.kaributesting.v10.groovy

import com.github.mvysny.kaributesting.v10.LocatorKt
import com.github.mvysny.kaributesting.v10.SearchSpec
import com.vaadin.flow.component.Component
import groovy.transform.CompileStatic
import kotlin.Unit
import kotlin.jvm.functions.Function1
import org.jetbrains.annotations.NotNull

/**
 * Just static-import all methods from this class.
 * @author mavi
 */
@CompileStatic
class LocatorG {
    /**
     * Finds a VISIBLE component in the current UI of given clazz which
     * matches given block. The {@link com.vaadin.flow.component.UI#getCurrent()} and all of its descendants are searched.
     * 
     * Example of use:
     *      * _get(Button, { caption = "Foo" })._click()
     * 
     * @param clazz the component must be of this class.
     * @param block the search specification
     * @return the only matching component, never null.
     * @throws IllegalArgumentException if no component matched, or if more than one component matches.
     */
    @NotNull
    static  C _get(@NotNull Class clazz,
                                        @NotNull @DelegatesTo(type = "com.github.mvysny.kaributesting.v10.SearchSpec", strategy = Closure.DELEGATE_FIRST) Closure spec = {}) {
        LocatorKt._get(clazz, new Function1, Unit>() {
            @Override
            Unit invoke(SearchSpec tSearchSpec) {
                spec.resolveStrategy = Closure.DELEGATE_FIRST
                spec.delegate = tSearchSpec
                spec()
                return Unit.INSTANCE
            }
        } as Function1)
    }

    /**
     * Finds a list of VISIBLE components of given clazz which matches
     * block. The {@link com.vaadin.flow.component.UI#getCurrent()} and all of its descendants are searched.
     * 
     * Example of use:
     *      * _find(Button, { caption = "Foo" })
     * 
     * @return the list of matching components, may be empty.
     */
    @NotNull
    static  List _find(@NotNull Class clazz,
                                               @NotNull @DelegatesTo(type = "com.github.mvysny.kaributesting.v10.SearchSpec", strategy = Closure.DELEGATE_FIRST) Closure spec = {}) {
        LocatorKt._find(clazz, new Function1, Unit>() {
            @Override
            Unit invoke(SearchSpec tSearchSpec) {
                spec.resolveStrategy = Closure.DELEGATE_FIRST
                spec.delegate = tSearchSpec
                spec()
                return Unit.INSTANCE
            }
        } as Function1)
    }

    /**
     * Expects that there are no VISIBLE components in the current UI of given
     * clazz which matches block. The {@link com.vaadin.flow.component.UI#getCurrent()} and all of its descendants are searched.
     * 
     * Example of use:
     *      * _expectNone(Button, { caption = "Foo" })
     * 
     * @throws IllegalArgumentException if one or more components matched.
     */
    static  void _expectNone(@NotNull Class clazz,
                                                  @NotNull @DelegatesTo(type = "com.github.mvysny.kaributesting.v10.SearchSpec", strategy = Closure.DELEGATE_FIRST) Closure spec = {}) {
        LocatorKt._expectNone(clazz, new Function1, Unit>() {
            @Override
            Unit invoke(SearchSpec tSearchSpec) {
                spec.resolveStrategy = Closure.DELEGATE_FIRST
                spec.delegate = tSearchSpec
                spec()
                return Unit.INSTANCE
            }
        } as Function1)
    }

    /**
     * Expects that there is exactly one VISIBLE components in the current UI of
     * given clazz which matches block. The {@link com.vaadin.flow.component.UI#getCurrent()} and all of its descendants are searched.
     * 
     * Example of use:
     *      * _expectOne(Button, { caption = "Foo" })
     * 
     * @throws AssertionError if none, or more than one components matched.
     */
    static  void _expectOne(@NotNull Class clazz,
                                                 @NotNull @DelegatesTo(type = "com.github.mvysny.kaributesting.v10.SearchSpec", strategy = Closure.DELEGATE_FIRST) Closure spec = {}) {
        LocatorKt._expectOne(clazz, new Function1, Unit>() {
            @Override
            Unit invoke(SearchSpec tSearchSpec) {
                spec.resolveStrategy = Closure.DELEGATE_FIRST
                spec.delegate = tSearchSpec
                spec()
                return Unit.INSTANCE
            }
        } as Function1)
    }

    /**
     * Expects that there are exactly count VISIBLE components in the current
     * UI with given clazz match block. The {@link com.vaadin.flow.component.UI#getCurrent()}
     * and all of its descendants are searched. Examples:
     *      * // check that there are 5 buttons in a button bar
     * buttonBar._expect(Button, 5)
     * // check that there are either 3, 4 or 5 vertical layouts in the UI with given class
     * _expect(VerticalLayout, { count = 3..5; styles = "menubar" })
     * 
     * Special cases: for asserting one component use {@link #_expectOne(java.lang.Class)}.
     * For asserting no components use {@link #_expectNone(java.lang.Class)}. They provide
     * a better error message in case of a failure, and also communicate your intent
     * as a test writer better in the test code.
     * @throws AssertionError if incorrect count of component matched.
     */
    static  void _expect(@NotNull Class clazz,
                                              @NotNull int count = 1,
                                              @NotNull @DelegatesTo(type = "com.github.mvysny.kaributesting.v10.SearchSpec", strategy = Closure.DELEGATE_FIRST) Closure spec = {}) {
        LocatorKt._expect(clazz, count, new Function1, Unit>() {
            @Override
            Unit invoke(SearchSpec tSearchSpec) {
                spec.resolveStrategy = Closure.DELEGATE_FIRST
                spec.delegate = tSearchSpec
                spec()
                return Unit.INSTANCE
            }
        } as Function1)
    }
}