Drama Finder

Type-safe Playwright element wrappers for testing Vaadin applications. Find elements using accessibility-first patterns and test with confidence.

Get Started API Reference

            
              {`@Test
                            public void testTextField() {
                            TextFieldElement field = 
                              TextFieldElement.getByLabel(
                                page, "Username"
                              );

                            field.setValue("john.doe");
                            field.assertValue("john.doe");
                            field.assertEnabled();
                            }`}

Quick Start

Get up and running with Drama Finder in minutes

Add Drama Finder to your Maven project's test dependencies: ```xml pom.xml theme={null} org.vaadin.addons dramafinder 1.1.0 test ``` Extend `AbstractBasePlaywrightIT` to get automatic Playwright setup: ```java SimpleViewIT.java theme={null} @SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT) public class SimpleViewIT extends AbstractBasePlaywrightIT { @LocalServerPort private int port; @Override public String getUrl() { return String.format("http://localhost:%d/", port); } } ``` Use element wrappers to interact with Vaadin components: ```java theme={null} @Test public void testLogin() { TextFieldElement username = TextFieldElement.getByLabel(page, "Username"); PasswordFieldElement password = PasswordFieldElement.getByLabel(page, "Password"); ButtonElement submit = ButtonElement.getByText(page, "Login"); username.setValue("admin"); password.setValue("secret"); submit.click(); // Assert navigation to dashboard assertThat(page).hasURL(Pattern.compile(".*/dashboard")); } ``` Execute integration tests with Maven: ```bash theme={null} mvn verify ``` ``` [INFO] Running SimpleViewIT [INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 [INFO] [INFO] Results: [INFO] [INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 ```

Key Features

Everything you need for robust Vaadin testing

40+ typed element classes for Vaadin components with compile-time safety Find elements using ARIA roles and accessible names, just like assistive technologies Built-in assertions that automatically retry until timeout, eliminating flaky tests Automatic shadow DOM piercing with scoped element lookups Shared behaviors through composable interfaces like HasInputFieldElement First-class integration with Spring Boot test framework

Explore by Topic

Deep dive into Drama Finder concepts and patterns

Learn how to find elements using factory methods and ARIA roles Master assertion patterns with automatic retry logic Understand locator delegation and scoped lookups Follow proven patterns for maintainable tests Explore real-world testing scenarios Solutions to common issues

Component Reference

Browse element wrappers by category

Form Inputs

Text fields, checkboxes, date pickers, and more

View elements

Buttons & Actions

Interactive button elements with click actions

View elements

Overlays

Dialogs, notifications, and popover components

View elements

Data Display

Grids, lists, and data visualization components

View elements

Ready to write better tests?

Start testing your Vaadin application with type-safe, accessibility-first element wrappers.

Get Started Now