如何使用测试语句

本部分讨论了Squish提供的API来执行生成测试结果的测试。验证点也使用此测试API；更多关于验证点的信息在如何创建和使用验证点部分中提供。测试结果日志的处理在处理测试结果部分中进行讨论。

要比较两个值并将比较结果写入测试日志，请使用Boolean test.compare(value1, value2)函数。要简单地检查某个条件是否为真（即检查布尔值），请使用Boolean test.verify(condition)函数。要将一些中性信息写入测试日志的特定测试运行点，请使用test.log(message)函数，要将警告写入测试日志，请使用test.warning(message)函数。

下面是一些示例，展示了如何使用这些函数。

lineedit = waitForObject(":Address Book - Add.Forename:_QLabel")
test.verify(lineedit.enabled)
test.compare(lineedit.text, "Jane")
test.log("Important note", "This is an important note about the test")
test.warning("Suspicious warning",
        "This test is incomplete and should be extended!")

var lineedit = waitForObject(":Address Book - Add.Forename:_QLabel");
test.verify(lineedit.enabled);
test.compare(lineedit.text, "John");
test.log("Important note", "This is an important note about the test");
test.warning("Suspicious warning",
        "This test is incomplete and should be extended!");

my $lineedit = waitForObject(":Address Book - Add.Forename:_QLabel");
test::verify($lineedit->enabled);
test::compare($lineedit->text, "Jane");
test::log("Important note", "This is an important note about the test");
test::warning("Suspicious warning",
        "This test is incomplete and should be extended!");

lineedit = waitForObject(":Address Book - Add.Forename:_QLabel")
Test.verify(lineedit.enabled)
Test.compare(lineedit.text, "Jane")
Test.log("Important note", "This is an important note about the test")
Test.warning("Suspicious warning",
        "This test is incomplete and should be extended!")

set lineedit [waitForObject ":Address Book - Add.Forename:_QLabel"]
test verify [property get $lineedit enabled]
test compare [property get $lineedit text] "John"
test log "Important note" "This is an important note about the test"
test warning "Suspicious warning" \
        "This test is incomplete and should be extended!"

test.log(message)和test.warning(message)函数都可以接受一个或两个参数，第一个是"message"文本，可选的第二个参数可以用来提供额外细节。

其他许多测试函数可供使用，包括验证预期的失败和异常的函数，以及将消息写入测试日志的各种函数。完整API在验证函数部分中进行了文档说明，该部分位于工具参考中。