Obsolete Members for TestCase

The following members of QML type TestCase are deprecated. They are provided to keep old source code working. We strongly advise against using them in new code.

Properties

Methods

Property Documentation

optional : bool [deprecated in 6.12]

This property is deprecated since QtTest 6.12. We strongly advise against using it in new code.

Use skip() instead.

Multiple TestCase types can be supplied in a test application. The application will exit once they have all completed. If a test case does not need to run (because a precondition has failed), then this property can be set to true. The default value is false.

TestCase {
    when: false
    optional: true
    function test_not_run() {
        verify(false)
    }
}

See also when and completed.


Method Documentation

[deprecated in 6.5] bool waitForItemPolished(object item, int timeout = 5000)

This method is deprecated since QtTest 6.5. We strongly advise against using it in new code.

Use waitForPolish() instead.

Waits for timeout milliseconds or until updatePolish() has been called on item.

Returns true if updatePolish() was called on item within timeout milliseconds, otherwise returns false.

See also isPolishScheduled(), QQuickItem::polish(), and QQuickItem::updatePolish().


© 2026 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.