QF-Test testes JavaFX applications

Testing JavaFX applications with QF-Test has been supported since the launch of JavaFX.

Testing JavaFX with QF-Test I UI test automation

QF-Test supports JavaFX specifically WebView, JxBrowser, Webswing and JPro cross-platform on Windows, Linux and macOS. QF-Test itself is based on Java and therefore offers the best possible support for your JavaFX applications.

Recording your first JavaFX test with QF-Test – here’s how it works

QF-Test is built on Java itself, which allows it to integrate more deeply with the JavaFX runtime than generic UI testing tools. This enables precise addressing of even complex controls – without any changes to your source code.

Getting started follows a simple pattern:

  1. Connect your application – QF-Test automatically detects JavaFX applications at startup, including embedded WebView or JxBrowser components. No source code access required.

  2. Address controls directly – Unlike coordinate-based testing, QF-Test identifies JavaFX components using multiple criteria – reliably, even when layouts change. Complex components such as table cells, tree nodes, and dropdown entries are addressed via their logical structure.

  3. Cover hybrid applications in a single test run – If your JavaFX application includes an embedded browser, QF-Test switches seamlessly between the Java and web context. No second tool, no context switching.

  4. Run tests and integrate into continuous integration and build tools – QF-Test executes tests via command line, integrates directly with Jenkins, and delivers a complete report with error messages and screenshots for each run.

Test steps can be extracted into reusable procedures and flexibly parameterized with external test data

What are QF-Test’s special features for testing JavaFX applications?

Modularized testing of complex components

QF-Test can directly address and validate sub-items of complex components, such as addressing a table cell via its row and column information. These steps can be conveniently recorded and modularized, allowing easy reuse and leading to low-maintenance tests.

Tests on all platforms

With QF-Test you can test JavaFX apps cross-platform on:

  • Windows
  • Linux
  • macOS
Mutual embedding of JavaFX into Swing, SWT/Eclipse and Web-Browsers

JavaFX is often combined with other Java UI technologies, e.g. Swing or SWT and of course web. Thus it is particularly important that QF-Test is ready for use when migrating from Swing or SWT to JavaFX. This allows automated Java Swing or SWT tests created with QF-Test to be reused for JavaFX with little effort, even combined for embedded components. If parts of the JavaFX application are implemented in an embedded browser like WebView or JxBrowser, QF-Test fully supports that as well.

Access to the entire JavaFX API

The following scripting languages offer full access to the JavaFX application under test:

  • Jython
  • Groovy
  • JavaScript

From Swing to JavaFX – your tests stay intact

Many teams migrate existing Swing applications to JavaFX step by step. QF-Test supports exactly this transition:

  • Swing and JavaFX components can be addressed in parallel within the same test suite – ideal for hybrid transition phases
  • Existing test logic, procedures, and data drivers remain usable without modification
  • Component recognition adapts to the new technology without requiring test cases to be re-recorded
  • JavaFX applications deployed to the web via Webswing or JPro can be covered with the same tests

Case study: migration from Swing to JavaFX at Centris AG

“Janitza has been using QF-Test extensively over many years to live up to the constant growth and guarantee a high bar of quality at the same time.Starting with a Swing application, the technology switches to JavaFX, JxBrowser and web applications were also covered effectively with QF-Test.”
Tristan Himmelreich, Diplom-Informatiker | Research & Development,
Janitza electronics GmbH, Germany
“Personally, I want to stress again the good customer service. Just a few days ago we had technical problems with our nightly-build relating to JavaFx. Within a very short time QFS service reacted, analysed our problem and sent us a patch. Top – Keep it up!”
Alexander Orbach, Software Development Automation,
HF MIXING GROUP, Freudenberg, Germany

Practical examples for testing JavaFX applications with QF-Test

QF-Test has supported JavaFX since 2014 and covers all typical challenges – from complex controls such as tables and trees to CI integration and cross-platform testing.

Practical recommendations:

  • Address complex controls directly: Table rows, TreeItems, and ComboBox entries can be targeted in QF-Test via their logical structure rather than screen coordinates – making tests resilient to layout changes. Java test automation with QF-Test

  • Modularize and reuse tests: Recorded steps can be extracted into procedures, combined with variables and external test data (Excel, database), and reused across multiple test suites. Data-driven testing with QF-Test

  • Integrate JavaFX tests into CI/CD: QF-Test runs via command line and integrates directly with Jenkins or other pipelines – including JavaFX applications running across multiple platforms. Regression testing with QF-Test

JavaFX future

JavaFX was released as an essential part of Java 8 and Oracle’s main intention was a unified solution comprised of an API for UI components, HTML/CSS and JavaScript with embedded browsers like JxBrowser and WebView and media like animations, video, audio as well as 2D and 3D. With Java 11 JavaFX was moved out of the JDK into the open source project OpenJFX. To this day OpenJFX is led by Oracle together with Gluon and supported by many other active participants.

Oracle announced at the JavaFX Adopters Meeting 2020 to extend support for their proprietary JavaFX 8 until 2025. Builds of the open-source variant OpenJFX and longstanding support contracts for that are offered by Gluon.

The Java SE Support Roadmap applies to JavaFX technology, taking into account “Web Deployment Technology and JavaFX” for earlier versions. Current JavaFX releases can be found at jdk.java.net/javafx22, as well as the JavaFX 23 early access builds.

Testing JavaFX applications with QF-Test
Do you want to test your JavaFX / OpenJFX application as well?

Then try QF-Test for the quality assurance of your JavaFX or OpenJFX software!

Just contact us that we can make an appointment for a demo webinar with one of our experienced experts.

Articles about QF-Test for JavaFX

Interested in QF-Test?

Tell us about your project, and we’ll personally show you how QF-Test can support you.

Frequently asked questions (FAQ)

Can QF-Test handle hybrid JavaFX applications with an embedded browser?

Yes – QF-Test switches seamlessly between Java and web context.

If your JavaFX application includes a WebView or JxBrowser component, QF-Test automatically recognizes both contexts. You can control and verify Java-side actions and web content within the same test suite – no context switching, no second testing tool required.

What happens to my tests when I migrate from Swing to JavaFX?

Existing QF-Test suites can be transferred with minimal effort.

QF-Test actively supports the migration process: test logic, procedures, and data drivers generally remain reusable. For components that have changed technically, QF-Test adapts the recognition accordingly – a complete rebuild of the test suite is not necessary in most cases.

Does QF-Test support OpenJFX and newer JavaFX versions?

Yes – QF-Test is continuously aligned with current OpenJFX releases.

Since JavaFX moved from Oracle to OpenJFX, QF-Test has kept pace with current releases. New JavaFX versions are supported as part of the regular QF-Test release cycle. Gluon builds and early-access versions can be reviewed on request.

Automated Desktop Application Testing with QF-Test

QF-Test enables professional and efficient automation of desktop application testing. Both Java-based and classic Windows applications can be tested easily, resulting in robust, low-maintenance test cases. With its intuitive interface, flexible script integration, and broad UI support, QF-Test is an ideal solution for quality assurance within your software project.

Desktop Application Testing

We use "Matomo" cookies to anonymously evaluate your visit to our website. For this we need your consent, which is valid for twelve months.

Cookie Configuration

Functional cookies

We use functional cookies to ensure the basic functionality of the website.

Performance and statistics cookies

We use Matomo for analyzing and optimizing our website. Cookies permit an anonymous collection of information that help us offering you a clear and user-friendly visit of our web pages.

Cookie details
Description Vendor Lifetime Type Purpose
_pk_id Matomo 13 Months HTTP Contains a unique, pseudonymized visitor ID internal to Matomo for recognizing returning visitors.
_pk_ref Matomo 6 Months HTTP Used to track from which website the anonymized user proceeded to our website.
_pk_ses Matomo 1 Day HTTP The Matomo session cookie is used to track the visitor's page requests during the session.
_pk_testcookie Matomo Session HTTP Used to check whether the visitor's browser supports cookies.
_pk_cvar Matomo 30 Minutes HTTP Temporarily store data about the visit.
_pk_hsr Matomo 30 Minutes HTTP Temporarily store data about the visit.