mozilla

Compare Revisions

Peptest

Change Revisions

Revision 63068:

Revision 63068 by ahal on

Revision 348469:

Revision 348469 by ahal on

Title:
Peptest
Peptest
Slug:
Peptest
Peptest
Tags:
peptest, responsiveness
"peptest", "responsiveness"
Content:

Revision 63068
Revision 348469
t7    <p>t7    This page has moved to <a href="/en/Mozilla_automated_testing
 >/Peptest" title="Mozilla automated testing">Mozilla_automated_tes
 >ting/Peptest</a>
8      <a class="link-https" href="https://wiki.mozilla.org/Auto-t
>ools/Projects/peptest">Peptest</a> is an <a href="/en/Mozilla_aut 
>omated_testing" title="Mozilla automated testing">automated test  
>harness</a> designed to test the responsiveness of the UI thread  
>while various actions are performed. Tests are simple Javascript  
>files which can optionally import <a href="/en/Mozmill" title="Mo 
>zmill">Mozmill's</a> driver to manipulate the user interface in a 
>n automated fashion. 
9    </p>
10    <p>
11      The code is currently located at <a class="external free" h
>ref="https://github.com/mozilla/peptest" rel="nofollow">https://g 
>ithub.com/mozilla/peptest</a>. <a class="link-https" href="https: 
>//wiki.mozilla.org/Auto-tools/Projects/peptest">Peptest</a> is al 
>so checked in to <a class="external text" href="http://mxr.mozill 
>a.org/mozilla-central/source/testing/peptest/" rel="nofollow">Moz 
>illa Central</a>. Firefox tests can be added to the <a class="ext 
>ernal text" href="http://mxr.mozilla.org/mozilla-central/source/t 
>esting/peptest/tests/firefox/" rel="nofollow">tests directory</a> 
> (don't forget to also add them to the manifest). 
12    </p>
13    <p>
14      For a longer description of what 'unresponsiveness' actuall
>y means, see: <a class="external free" href="http://blog.mozilla. 
>com/ted/2011/06/27/measuring-ui-responsiveness/" rel="nofollow">h 
>ttp://blog.mozilla.com/ted/2011/06/27/measuring-ui-responsiveness 
>/</a> 
15    </p>
16    <h2 id="Running_Tests">
17      Running Tests
18    </h2>
19    <p>
20      For instructions on installing and running Peptest standalo
>ne from the command line see <a class="link-https" href="https:// 
>wiki.mozilla.org/Auto-tools/Projects/peptest#Using_Peptest">Using 
> Peptest</a>. 
21    </p>
22    <p>
23      To run Peptest within Mozilla Central, first <a href="/En/D
>eveloper_Guide/Build_Instructions" title="en/Build_Documentation" 
>>build Mozilla</a> with your changes; then: 
24    </p>
25    <pre>
26cd $(OBJDIR)
27make peptest
28</pre>
29    <p>
30      This will run the default set of tests. To run a different 
>test manifest or test file you can set the $TEST_PATH environment 
> variable: 
31    </p>
32    <pre>
33TEST_PATH=path/to/my/test/manifest make peptest
34</pre>
35    <p>
36      You can also add additional arguments to Peptest using the 
>$EXTRA_TEST_ARGS environment variable: 
37    </p>
38    <pre>
39EXTRA_TEST_ARGS="--log-level=DEBUG --profile-path=path/to/custom/
>profile" make peptest 
40</pre>
41    <p>
42      Here is a full list of options that can be passed into the 
>$EXTRA_TEST_ARGS environment variable: 
43    </p>
44    <p>
45      <strong>Options:</strong><br>
46      &nbsp; -t TESTPATH, --test-path=TESTPATH<br>
47      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; path to the test manifest<br> 
48      &nbsp; -b BINARY, --binary=BINARY<br>
49      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; absolute path to application, overriding default<b 
>r> 
50      &nbsp; --app=APP&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&
>nbsp;&nbsp;&nbsp;&nbsp;&nbsp; app to run the tests on (firefox or 
> thunderbird).<br> 
51      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; defaults to firefox 
52    </p>
53    <p>
54      &nbsp; --timeout=TIMEOUT&nbsp;&nbsp;&nbsp;&nbsp; global tim
>eout in seconds (with no output)<br> 
55      &nbsp; --log-file=FILE&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
>file to which logging occurs<br> 
56      &nbsp; --log-level=LEVEL&nbsp;&nbsp;&nbsp;&nbsp; one of DEB
>UG, INFO, WARNING, ERROR to determine the<br> 
57      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; level of logging<br> 
58      &nbsp; --setenv=NAME=VALUE&nbsp;&nbsp; sets the given varia
>ble in the application's<br> 
59      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; environment<br> 
60      &nbsp; --browser-arg=ARG&nbsp;&nbsp;&nbsp;&nbsp; provides a
>n argument to the test application<br> 
61      &nbsp; -p PROFILEPATH, --profile-path=PROFILEPATH<br>
62      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; path to the profile to use. If none specified, a<b 
>r> 
63      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; temporary profile is created<br> 
64      &nbsp; --server-port=SERVERPORT<br>
65      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; The port to host test related files on<br> 
66      &nbsp; --server-path=SERVERPATH<br>
67      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; Starts a basic HTTP server rooted at the specified 
><br> 
68      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; directory. Can be used for hosting test related fi 
>les<br> 
69      &nbsp; --symbols-path=SYMBOLSPATH<br>
70      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; absolute path to directory containing breakpad<br> 
71      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; symbols, or the URL of a zip file containing symbo 
>ls<br> 
72      &nbsp; --tracer-threshold=TRACERTHRESHOLD<br>
73      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; time in milliseconds at which point an event is<br 
>> 
74      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; considered unresponsive. Default to 50ms<br> 
75      &nbsp; --tracer-interval=TRACERINTERVAL<br>
76      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; interval in milliseconds that tracer events are se 
>nt<br> 
77      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp
>;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbs 
>p;&nbsp;&nbsp; through the event loop. Default to 10ms 
78    </p>

Back to History