author Bas Schouten <>
Mon, 16 Aug 2010 09:15:03 +0200
changeset 50660 3fc41668b25c0c748671964328c5310df4377eda
parent 4322 dbb9fc57f0363121e485eed396931e8030ba6f04
permissions -rw-r--r--
Fix line-endings in gfxWindowsPlatform.

Pageload Test Component


  ./firefox -tp file:///path/to/manifest.txt [-tpargs...]

See ./firefox -help for other arguments.

Manifest file format

Comments in the manifest file start with a #.  Each line may be:

* a URL (absolute or relative to the manifest)

This URL is added to the list of tests.

* one or more flags, followed by whitespace, followed by a URL

The only flag supported currently is '%', which indicates that
a test will do its own timing.  (See Self-timing Tests below.)

* "include" followed by whitespace, followed by a URL

Parse the given manifest file.

Self-timing Tests

Most timing tests are interested in timing how long it takes the page
to load; that is, from the start of page loading until the 'load'
event is dispatched.  By default, this is what the pageloader will
time.  However, if a test URL has the % flag, the test is expected to
report its own timing.  For this purpose, the pageloader will provide
a function named "tpRecordTime" in the test's global object that it
should call once it has performed whatever timing it wants to do.
The given value will be used as the timing result for this test.

Output format

The result is a dump to stdout via dump() --
browser.dom.window.dump.enabled must be set to true in the profile.  A
number of output formats can be specified via the -tpformat command
line option, currently 'js', 'text', and 'tinderbox' are supported.

Sample 'js' format output:

([({page:"1280x1024-PNG/index.html", value:133, stddev:20.049937655763422}),({page:"", value:233, stddev:36.66606060105176}),({page:"", value:117.6, stddev:1.2}),({page:"", value:97.8, stddev:47.41898354035017}),])

Sample 'text' format output:

    Page                                     mean  stdd   min   max raw
  0 1280x1024-PNG/index.html                  133    20   121   297 297,173,122,121,124,125
  1           233    37   192   395 395,273,223,192,198,279
  2                    118     1   116   254 254,117,116,119,119,117
  3               98    47     3   124 3,121,120,124,124,121

Sample 'tinderbox' format output:


Note that the minimum, maximum, stddev are not calculated; they're
always reported as NaN.  (They were the minimum and maximum values of
any sampled value, and the standard deviation across all sampled
values -- not very useful.)


* Command line option to choose whether to run with or without browser chrome.  Currently runs without.

* Tinderbox-dropping style output
  * better yet would be to teach tinderbox about JSON