Performance/Pageloader: Difference between revisions

no edit summary
(Created page with 'The pageloader component is the core of many of the performance tests that we run via Talos and otherwise, including Tp3, Tsvg, Tgfx, and others. == Installation == If you have...')
 
No edit summary
Line 14: Line 14:


If you wish to examine or modify the pageloader, the code lives in [http://hg.mozilla.org/mozilla-central/file/tip/layout/tools/pageloader mozilla/layout/tools/pageloader].  You can either manually run make inside that directory in your objdir.
If you wish to examine or modify the pageloader, the code lives in [http://hg.mozilla.org/mozilla-central/file/tip/layout/tools/pageloader mozilla/layout/tools/pageloader].  You can either manually run make inside that directory in your objdir.
== Running ==
The pageloader is driven by a manifest file and a set of command line flags.  Running ./firefox -help shows the pageloader options, all of which start with "-tp".  If these aren't present, then the pageloader components are not available or correctly installed.
<h4>-tp <i>file</i></h4>
Required.  <i>file</i> contains the manifest of pages to test; see below for more information.
<h4>-tpcycles <i>n</i></h4>
Default: 5.  Loop through the selected pages from the manifest <i>n</i> times.
<h4>-tpfilter <i>regexp</i></h4>
Optional.  Only include pages from the manifest that match <i>regexp</i>.
<h4>-tpstart <i>n</i></h4>
Optional.  Start on the <i>n</i>th entry in the manifest.
<h4>-tpend <i>n</i></h4>
Optional.  End on the <i>n<i>th entry in the manifest.
<h4>-tpformat <i>f1,f2,...</i></h4>
Display results in the given formats.  Supported formats are <i>text</i>,<i>tinderbox</i>,<i>js</i>,<i>jsfull</i>.  See below for samples of each format.
<h4>-tpchrome</h4>
Run tests within the full browser chrome.  Without this flag, pages are loaded in a plain toplevel window, without any additional browser functionality enabled.
<h4>-tprender</h4>
Run the render benchmark for each page in the manifest, along with timing page load.  This will time how long it takes to redraw each page once it's already been loaded, and is most useful for measuring rendering speed.
<h4>-tpwidth <i>width</i>, -tpheight <i>height</i></h4>
Run the tests in a window of <i>width</i> x <i>height</i>.  Default: 1024x768.
<h4>-tpoffline</h4>
Force the browser into offline mode while running tests, to ensure that no network connections are created.
<h4>-tpnoisy</h4>
Dump the last loaded page to the console as the test progresses.
<h4>-tptimeout <i>n</i></h4>
Default: none.  Maximum amount of time to wait for a page to load, in milliseconds; if the page takes longer than this to load, abort.
<h4>-tpnoforcecc</h4>
Don't force cycle collection between each pageload.  If this isn't done, pageload times can be skewed due to cycle collection kicking in while a page is loading.  In normal browsing usage, CC is done during times when the user is idle.
Confirmed users, Bureaucrats and Sysops emeriti
792

edits