- Qt Creator Documentation
- Create Qt Quick tests
- Qt Creator 17.0.1

How To

# Create Qt Quick tests

Qt Creator integrates the Qt Quick Test unit test framework for Qt Quick applications, where you write test cases as JavaScript functions.

To create a Qt Quick test:

1. Go to File > New Project > Test Project.
2. Select Qt Quick Test Project > Choose.
3. In the Project and Test Information dialog, specify settings for the project and test.

4. In Test case name, enter a name for the test case.
5. Select Generate setup code to execute C++ code before running any of the QML tests. The testing framework will call slots and invocable functions, as described in Executing C++ Before QML Tests.
6. Select Generate initialization and cleanup code to add functions to your test that the testing framework executes to initialize and clean up the test.
7. In Build system, select the build system to use for building the project: CMake, qmake, or Qbs. To build with CMake when developing with Qt 5 or Qt 6.4 or earlier, select CMake for Qt 5 and Qt 6.

Qt Creator creates the test in the specified project directory. Edit the .cpp file to add private slots for each test function in your test.

Note: While scanning for tests, the parser takes into account only files that directly or indirectly include QuickTest or its equivalent `QtQuickTest/quicktest.h`. If one gets found, it tries to detect statements to create a Qt Quick test application and if it can find any it will parse respective QML files. If the C++ part will not be built with the current configuration, there will be no automatic scanning of QML files.

See also How To: Test, Select the build system, Testing, and Test Results.

How To