ui-unit-testing

Write and run browser-free UI unit tests for Vaadin 25 server-side views.

11|3|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/vaadin/claude-plugin --skill ui-unit-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ui-unit-testing
Source: https://github.com/vaadin/claude-plugin/tree/main/skills/ui-unit-testing
Command: npx skills add https://github.com/vaadin/claude-plugin --skill ui-unit-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Server-side Vaadin views are often slow and flaky to test when using browsers or full end-to-end stacks. This Skill enables fast, deterministic, browser-free unit tests that exercise view logic, navigation, and component interactions inside the JVM to make CI feedback rapid and reliable.

Core Features & Use Cases

  • Browser-free execution: Run UI tests without a servlet container or real browser using UIUnitTest base classes.
  • Component testers and queries: Simulate user actions with typed testers and query components with $() to assert visible behavior.
  • Navigation and Spring integration: Navigate to route-backed views, pass parameters, and run tests with Spring-aware bases to validate bean injection scenarios.
  • Use Case: Rapidly validate form validation, button-driven navigation, dialog content, and grid interactions in unit tests that run in milliseconds.

Quick Start

Write a UI unit test that navigates to HelloWorldView, sets the name field to Marcus, clicks the hello button, and asserts the notification text.

Frequently Asked Questions about ui-unit-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run browser-free UI unit tests for Vaadin views?

Browser-free UI unit tests for Vaadin views run inside the JVM without a real browser, using UIUnitTest base classes to execute component interactions and navigation checks in milliseconds.

Can I test Spring bean injection and navigation in Vaadin server-side views?

Yes, you can test Spring bean injection and navigation in Vaadin views by using optional Spring-aware test bases to validate bean injection scenarios and navigate to route-backed views with parameters.

How do I simulate user actions like button clicks and form validation in Vaadin tests?

You simulate user actions in Vaadin tests by using typed component testers and querying components with $() to interact with forms, click buttons, and assert visible behavior like notification text.

Do I need a servlet container or real browser to run Vaadin UI tests in CI?

No, you do not need a servlet container or real browser to run Vaadin UI tests in CI, because the tests execute deterministically inside the JVM using the Vaadin testbench unit dependency.

What is the best way to speed up flaky end-to-end Vaadin view testing?

The best way to speed up flaky Vaadin view testing is replacing browser-based end-to-end stacks with browser-free JVM unit tests that exercise view logic and component interactions deterministically.

Can I assert grid interactions and dialog content in Vaadin unit tests?

Yes, you can assert grid interactions and dialog content in Vaadin unit tests by using component testers to simulate user actions and querying the visible behavior of components inside the JVM.