Qst Service¶
-
class
Qst
¶ Drives test case execution and provides information about the environment.
Properties: | hostOs |
---|---|
Methods: | compare() , error() , info() ,
verify() , wait() |
Detailed Description¶
The Qst
service is an integral part of Qst. It contains methods for test
evaluation evaluation and provides information about test case execution and the
host environment.
Qst
is a singleton type and cannot be instantiated as a QML component.
Properties¶
Methods¶
-
void
compare
(variant actual, variant expected, string message)¶ Compares an actual value to an expected value. If actual and expected are identical, execution continues. If not, a failure is recorded in the test log and the test won’t be executed further. The string message is optional. If not set, a default message is created.
Both values may be of any basic QML basic type. Arrays are compared by their containing values. Objects are compared by each property.
When
compare()
fails during test case execution, the currentTestcase
aborts immediately, the result is set toTestcase::Result::Fail
and Qst proceeds with the next test case. When failing before the first test case starts, for instance in aProject
item, Qst exits and no test case will be executed at all.
-
void
error
(string message, string file, int line)¶ Throws an error with message and aborts the current test case.
The parameters file and line are optional. If omitted, Qst takes those from the top of the caller stack.
-
void
info
(variant message)¶ Prints message in the test log output. The parameter message can be anything that converts implicitly into a string.
-
void
verify
(bool condition, string message)¶ Checks whether the condition is true or not. If it is true, execution continues. If not, a failure is recorded in the test log and the test won’t be executed further.
When
verify()
fails during test case execution, the currentTestcase
aborts immediately, the result is set toTestcase::Result::Fail
and Qst proceeds with the next test case. When failing before the first test case starts, for instance in aProject
item, Qst exits and no test case will be executed at all.
-
void
wait
(int ms)¶ Waits for ms milliseconds. While waiting, events will be processed and the test stays responsive.
This function should be only used inside
Testcase::run()
. It is not recommended to call it in binding expressions.