Component

A component is a reusable piece of functionality that can be shared among several pages, and which interaction can be performed independently of other pieces in the web page.

// Given a component for the Kotlin's features
class Feature(page: Page, element: WebElement) : Component(page, element) {

    val title by lazy {
        `$`("h3.feature-title", 0).text
    }

    val description by lazy {
        `$`("p.feature-description", 0).text
    }

    override fun toString(): String {
        return "Feature(title = $title, description = $description)"
    }
}

// And a component of the section on features
class FeaturesSection(page: Page, element: WebElement) : Component(page, element) {

    val title by lazy {
        `$`("h2.section-header", 0).text
    }

    val features by lazy {
        `$`("li.kotlin-feature").component(::Feature)
    }
}

// And the Kotlin's website index page
class IndexPage(browser: Browser) : Page(browser) {

    override val url = "https://kotlinlang.org/"

    override val at = at {
        title == "Kotlin Programming Language"
    }

    val featuresSection by lazy {
        `$`("section.kotlin-overview-section._features", 0).component(::FeaturesSection)
    }
}

Browser.drive(driverFactory) {
    // When I visit the Kotlin's website index page
    val indexPage = to(::IndexPage)

    // Then the header for the features section must be correct
    assertEquals(indexPage.featuresSection.title, "Why Kotlin?")

    val actualFeatures = indexPage.featuresSection.features.associateBy(
        Feature::title, Feature::description
    )

    // And the features should be correctly described inside said section
    assertEquals(actualFeatures, expectedFeatures)
}

Parameters

page - the page the component is linked to.

rootElement - the component's root element.

Constructors

Properties

Extension Functions