Qt Test

Qt Test provides classes for unit testing Qt applications and libraries. All public methods are in the QTest namespace. In addition, the QSignalSpy class provides easy introspection for Qt's signals and slots.

Getting Started

To enable Qt Test in a project, add this directive into the C++ files:

#include <QtTest>

To link against Qt Test, add this line to the project file:

QT += testlib

Articles and Guides

Licenses and Attributions

Qt Test is available under commercial licenses from The Qt Company. In addition, it is available under free software licenses. Since Qt 5.4, these free software licenses are GNU Lesser General Public License, version 3, or the GNU General Public License, version 2. See Qt Licensing for further details.

Furthermore, Qt Test in Qt 5.10.1 may contain third party modules under following permissive licenses:


MIT License

Linux Performance Events

GNU General Public License v2.0 only


BSD 4-clause "Original" or "Old" License


These are links to the API reference materials.

© 2021 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.