1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- ../../doc/src/qtuitest_tutorial.qdoc -->
<head>
<title>Chapter 4: Putting It All Together</title>
<link rel="prev" href="qtuitest-tutorial3.html" />
<link rel="contents" href="qtuitest-tutorial.html" />
<link href="classic.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left" valign="top" width="32"><a href="http://qt.nokia.com/"><img src="images/qt-logo.png" align="left" border="0" /></a></td>
<td width="1"> </td><td align="right" valign="top" width="230"></td></tr></table><p>
[Previous: <a href="qtuitest-tutorial3.html">Chapter 3</a>]
[<a href="qtuitest-tutorial.html">Contents</a>]
</p>
<h1 class="title">Chapter 4: Putting It All Together<br /><span class="subtitle"></span>
</h1>
<p>Using the simple building blocks of textual input and output and navigation functions, with the data driven testing approach, a full testcase can be written for creating a new contact. Note that the functions for creating and verifying a contact have been moved out into helper functions; this allows them to be reused for subsequent tests. This is very useful for cases where, for instance, one test's precondition might be that a contact has been successfully created.</p>
<pre> testcase = {
initTestCase: function() {
<span class="comment">// Start "Contacts" when the testcase starts.</span>
startApplication( "Contacts" );
},
creating_a_contact: function(name, emails, company, jobTitle, businessPhone) {
create_contact(name, emails, company, jobTitle, businessPhone);
verify_contact(name, emails, company, jobTitle, businessPhone);
},
creating_a_contact_data: {
simple: [ "Billy Jones", "billy@example.com", "Hotdog Inc.", "Hotdog Engineer", "12345" ],
letters_in_phone: [ "Joan Example", "joan@example.com", "Example Inc.", "Exemplary Engineer", "555 EXA" ],
three_names: [ "Jon John Johnson", "jjj@example.com", "Sillynames Inc.", "Dog Walker", "12345" ],
no_job: [ "William Doe", "bill@example.net", undefined, undefined, undefined ]
}
}
<span class="comment"> // Create a contact with the given details.</span>
function create_contact(name, emails, company, jobTitle, businessPhone) {
<span class="comment">// Verify that we're on the home screen of the "Contacts" app.</span>
waitForTitle( "Contacts" );
<span class="comment">// Select "New contact" from context menu.</span>
select( "New contact", optionsMenu() );
<span class="comment">// Navigate to the "Contact" tab.</span>
<span class="comment">// This is the default tab, but with this code we ensure the</span>
<span class="comment">// test will work if it becomes no longer the default.</span>
select( "Contact", tabBar() );
<span class="comment">// Fill in fields on the "Contact" tab.</span>
<span class="comment">// enter() returns immediately if we try to enter an undefined</span>
<span class="comment">// value.</span>
enter( name, "Name" );
enter( emails, "Emails" );
<span class="comment">// Navigate to the "Business" tab.</span>
select( "Business", tabBar() );
<span class="comment">// Fill in fields on the "Business" tab.</span>
enter( company, "Company" );
enter( jobTitle, "Title" );
enter( businessPhone, "Phone" );
<span class="comment">// Press the Back key to commit the new contact</span>
select( "Back", softMenu() );
}
<span class="comment"> // Verify that a contact with the given details exists.</span>
function verify_contact(name, emails, company, jobTitle, businessPhone) {
<span class="comment">// Verify that we're on the contacts list.</span>
waitForTitle( "Contacts" );
<span class="comment">// Select the contact with the given name.</span>
select( name );
<span class="comment">// Navigate to the "Details" tab and get the displayed text.</span>
select( "Details", tabBar() );
var details = getText();
<span class="comment">// Now verify that the details contains all of the non-null information</span>
<span class="comment">// for the contact.</span>
if (name != undefined) verify( details.contains(name) );
if (emails != undefined) verify( details.contains(emails) );
if (company != undefined) verify( details.contains(company) );
if (jobTitle != undefined) verify( details.contains(jobTitle) );
if (businessPhone != undefined) verify( details.contains(businessPhone) );
}</pre>
<p>The above test has been written to be reasonably permissive; it will succeed as long as the text shown by the contacts application contains all of the information for the created contact, and it does not test things such as the formatting of the given text, and does not test every single field. However, this test is well insulated against minor changes to the tested application GUI.</p>
<p><a href="qtuitest.html">QtUiTest</a> allows the tester to decide how strict a test should be. If pixel-perfect accuracy is required for output, a test can be written to test every screen with <a href="qsystemtest.html#verifyImage">verifyImage()</a>. In contrast, a high-level text-based approach as shown above can result in effective tests which remain correct even when significant UI changes occur.</p>
<p>There are many other methods available for use; for further information, refer to the <a href="qsystemtest.html">QSystemTest</a> documentation.</p>
<p>
[Previous: <a href="qtuitest-tutorial3.html">Chapter 3</a>]
[<a href="qtuitest-tutorial.html">Contents</a>]
</p>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td width="30%" align="left">Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies)</td>
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
<td width="30%" align="right"><div align="right">QtUiTest</div></td>
</tr></table></div></address></body>
</html>
|
