diff options
Diffstat (limited to 'old/doc/html/qtuitest-tutorial3.html')
| -rw-r--r-- | old/doc/html/qtuitest-tutorial3.html | 105 |
1 files changed, 105 insertions, 0 deletions
diff --git a/old/doc/html/qtuitest-tutorial3.html b/old/doc/html/qtuitest-tutorial3.html new file mode 100644 index 0000000..880ee61 --- /dev/null +++ b/old/doc/html/qtuitest-tutorial3.html @@ -0,0 +1,105 @@ +<?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 3: Data driven testing</title> + <link rel="prev" href="qtuitest-tutorial2.html" /> + <link rel="contents" href="qtuitest-tutorial.html" /> + <link rel="next" href="qtuitest-tutorial4.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-tutorial2.html">Chapter 2</a>] +[<a href="qtuitest-tutorial.html">Contents</a>] +[Next: <a href="qtuitest-tutorial4.html">Chapter 4</a>] +</p> +<h1 class="title">Chapter 3: Data driven testing<br /><span class="subtitle"></span> +</h1> +<p>The first page of this tutorial gave an example of testing creation of a contact:</p> +<pre> creating_a_contact: function() + { + <span class="comment">// Start the application</span> + startApplication( "Contacts" ); + + <span class="comment">// Open the options menu and choose "New contact"</span> + select( "New contact", optionsMenu() ); + + <span class="comment">// Enter some details in the "Name" and "Emails" fields</span> + enter( "Frank Grimes", "Name" ); + enter( "frank@example.com", "Emails" ); + + <span class="comment">// Select 'Back' from the softkey menu to commit changes</span> + select( "Back", softMenu() ); + + <span class="comment">// We should now be at the contacts list.</span> + <span class="comment">// Verify that we can select the contact we just created.</span> + select( "Frank Grimes" ); + + <span class="comment">// We should now be viewing the contact.</span> + <span class="comment">// Move to "Details" tab.</span> + select( "Details", tabBar() ); + + <span class="comment">// Now verify that the details screen contains</span> + <span class="comment">// the expected details.</span> + var text = getText(); + verify( text.contains("Frank Grimes") ); + verify( text.contains("frank@example.com") ); + }</pre> +<p>One problem with this test function is that only one set of values is tested. If we want to test additional values, the best way to do it is with <a href="qtuitest.html">QtUiTest</a>'s built-in support for data driven testing.</p> +<p>We create a new object, named the same as our testfunction with '_data' appended, and we make the object consist of a series of arrays:</p> +<pre> creating_a_contact_data: { + simple: [ "Frank Grimes", "frank@example.com", "+61 0321 FRANK" ], + no_email: [ "Bob Jones", undefined, "+61 0321 BOB" ], + with_middlename: [ "Jane Middlename Doe", "jmd@example.com", undefined ] + }</pre> +<p><tt>testcase.creating_a_contact_data</tt> is a table of test data with rows <tt>simple</tt>, <tt>no_email</tt> and <tt>with_middlename</tt>. Each row has 3 columns, and these are passed to the <tt>creating_a_contact</tt> test function as the arguments <tt>name</tt>, <tt>email</tt>, <tt>homephone</tt> in the example below:</p> +<pre> creating_a_contact: function(name, email, homephone) + { + <span class="comment">// Start the application</span> + startApplication( "Contacts" ); + + <span class="comment">// Open the options menu and choose "New contact"</span> + select( "New contact", optionsMenu() ); + + <span class="comment">// Enter details</span> + enter( name, "Name" ); + enter( email, "Emails" ); + enter( homephone, "Home Phone" ); + + <span class="comment">// Select 'Back' from the softkey menu to commit changes</span> + select( "Back", softMenu() ); + + <span class="comment">// We should now be at the contacts list.</span> + <span class="comment">// Verify that we can select the contact we just created.</span> + select( name ); + + <span class="comment">// We should now be viewing the contact.</span> + <span class="comment">// Move to "Details" tab.</span> + select( "Details", tabBar() ); + + <span class="comment">// Now verify that the details screen contains</span> + <span class="comment">// the expected details.</span> + var text = getText(); + if (name != undefined) verify( text.contains(name) ); + if (email != undefined) verify( text.contains(email) ); + if (homephone != undefined) verify( text.contains(homephone) ); + }</pre> +<p>This test is now much more extensible. New test cases can simply be added as new rows to the testdata table and will automatically be tested without needing to add further logic to the test function.</p> +<p> +[Previous: <a href="qtuitest-tutorial2.html">Chapter 2</a>] +[<a href="qtuitest-tutorial.html">Contents</a>] +[Next: <a href="qtuitest-tutorial4.html">Chapter 4</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> |