| |
| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <html><head><title>Python: module telemetry.page.record_wpr</title> |
| </head><body bgcolor="#f0f0f8"> |
| |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading"> |
| <tr bgcolor="#7799ee"> |
| <td valign=bottom> <br> |
| <font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="telemetry.html"><font color="#ffffff">telemetry</font></a>.<a href="telemetry.page.html"><font color="#ffffff">page</font></a>.record_wpr</strong></big></big></font></td |
| ><td align=right valign=bottom |
| ><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="../telemetry/page/record_wpr.py">telemetry/page/record_wpr.py</a></font></td></tr></table> |
| <p><tt># Copyright (c) 2012 The Chromium Authors. All rights reserved.<br> |
| # Use of this source code is governed by a BSD-style license that can be<br> |
| # found in the LICENSE file.</tt></p> |
| <p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#aa55cc"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr> |
| |
| <tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td> |
| <td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="telemetry.core.browser_options.html">telemetry.core.browser_options</a><br> |
| <a href="telemetry.core.discover.html">telemetry.core.discover</a><br> |
| <a href="json.html">json</a><br> |
| <a href="logging.html">logging</a><br> |
| <a href="os.html">os</a><br> |
| </td><td width="25%" valign=top><a href="telemetry.page.page_measurement.html">telemetry.page.page_measurement</a><br> |
| <a href="telemetry.page.page_measurement_results.html">telemetry.page.page_measurement_results</a><br> |
| <a href="telemetry.page.page_runner.html">telemetry.page.page_runner</a><br> |
| <a href="telemetry.page.page_set.html">telemetry.page.page_set</a><br> |
| <a href="telemetry.page.page_test.html">telemetry.page.page_test</a><br> |
| </td><td width="25%" valign=top><a href="telemetry.page.profile_creator.html">telemetry.page.profile_creator</a><br> |
| <a href="sys.html">sys</a><br> |
| <a href="tempfile.html">tempfile</a><br> |
| <a href="telemetry.test.html">telemetry.test</a><br> |
| <a href="telemetry.page.test_expectations.html">telemetry.page.test_expectations</a><br> |
| </td><td width="25%" valign=top><a href="time.html">time</a><br> |
| <a href="urlparse.html">urlparse</a><br> |
| <a href="telemetry.core.util.html">telemetry.core.util</a><br> |
| <a href="telemetry.core.wpr_modes.html">telemetry.core.wpr_modes</a><br> |
| </td></tr></table></td></tr></table><p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#ee77aa"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr> |
| |
| <tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td> |
| <td width="100%"><dl> |
| <dt><font face="helvetica, arial"><a href="telemetry.page.page_test.html#PageTest">telemetry.page.page_test.PageTest</a>(<a href="telemetry.core.command_line.html#ArgumentHandlerMixIn">telemetry.core.command_line.ArgumentHandlerMixIn</a>) |
| </font></dt><dd> |
| <dl> |
| <dt><font face="helvetica, arial"><a href="telemetry.page.record_wpr.html#RecordPage">RecordPage</a> |
| </font></dt></dl> |
| </dd> |
| </dl> |
| <p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#ffc8d8"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#000000" face="helvetica, arial"><a name="RecordPage">class <strong>RecordPage</strong></a>(<a href="telemetry.page.page_test.html#PageTest">telemetry.page.page_test.PageTest</a>)</font></td></tr> |
| |
| <tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td> |
| <td width="100%"><dl><dt>Method resolution order:</dt> |
| <dd><a href="telemetry.page.record_wpr.html#RecordPage">RecordPage</a></dd> |
| <dd><a href="telemetry.page.page_test.html#PageTest">telemetry.page.page_test.PageTest</a></dd> |
| <dd><a href="telemetry.core.command_line.html#ArgumentHandlerMixIn">telemetry.core.command_line.ArgumentHandlerMixIn</a></dd> |
| <dd><a href="__builtin__.html#object">__builtin__.object</a></dd> |
| </dl> |
| <hr> |
| Methods defined here:<br> |
| <dl><dt><a name="RecordPage-CanRunForPage"><strong>CanRunForPage</strong></a>(self, page)</dt></dl> |
| |
| <dl><dt><a name="RecordPage-CustomizeBrowserOptionsForPageSet"><strong>CustomizeBrowserOptionsForPageSet</strong></a>(self, pset, options)</dt></dl> |
| |
| <dl><dt><a name="RecordPage-DidNavigateToPage"><strong>DidNavigateToPage</strong></a>(self, page, tab)</dt><dd><tt>Forward the call to the test.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-Run"><strong>Run</strong></a>(self, page, tab, results)</dt></dl> |
| |
| <dl><dt><a name="RecordPage-WillNavigateToPage"><strong>WillNavigateToPage</strong></a>(self, page, tab)</dt><dd><tt>Override to ensure all resources are fetched from network.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-__init__"><strong>__init__</strong></a>(self, measurements)</dt></dl> |
| |
| <hr> |
| Methods inherited from <a href="telemetry.page.page_test.html#PageTest">telemetry.page.page_test.PageTest</a>:<br> |
| <dl><dt><a name="RecordPage-CleanUpAfterPage"><strong>CleanUpAfterPage</strong></a>(self, page, tab)</dt><dd><tt>Called after the test run method was run, even if it failed.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-CreateExpectations"><strong>CreateExpectations</strong></a>(self, page_set)</dt><dd><tt>Override to make this test generate its own expectations instead of<br> |
| any that may have been defined in the page set.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-CreatePageSet"><strong>CreatePageSet</strong></a>(self, args, options)</dt><dd><tt>Override to make this test generate its own page set instead of<br> |
| allowing arbitrary page sets entered from the command-line.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-CustomizeBrowserOptions"><strong>CustomizeBrowserOptions</strong></a>(self, options)</dt><dd><tt>Override to add test-specific options to the BrowserOptions object</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-CustomizeBrowserOptionsForSinglePage"><strong>CustomizeBrowserOptionsForSinglePage</strong></a>(self, page, options)</dt><dd><tt>Set options specific to the test and the given page.<br> |
| <br> |
| This will be called with the current page when the browser is (re)started.<br> |
| Changing options at this point only makes sense if the browser is being<br> |
| restarted for each page. Note that if page has a startup_url, the browser<br> |
| will always be restarted for each run.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-DidRunAction"><strong>DidRunAction</strong></a>(self, page, tab, action)</dt><dd><tt>Override to do operations after running the action on the page.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-DidRunActions"><strong>DidRunActions</strong></a>(self, page, tab)</dt><dd><tt>Override to do operations after running the actions on the page.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-DidRunPageRepeats"><strong>DidRunPageRepeats</strong></a>(self, page)</dt><dd><tt>Override to do operations after each page is iterated over.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-DidRunTest"><strong>DidRunTest</strong></a>(self, browser, results)</dt><dd><tt>Override to do operations after all page set(s) are completed.<br> |
| <br> |
| This will occur before the browser is torn down.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-DidStartBrowser"><strong>DidStartBrowser</strong></a>(self, browser)</dt><dd><tt>Override to customize the browser right after it has launched.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-DidStartHTTPServer"><strong>DidStartHTTPServer</strong></a>(self, tab)</dt><dd><tt>Override to do operations after the HTTP server is started.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-IsExiting"><strong>IsExiting</strong></a>(self)</dt></dl> |
| |
| <dl><dt><a name="RecordPage-RequestExit"><strong>RequestExit</strong></a>(self)</dt></dl> |
| |
| <dl><dt><a name="RecordPage-RestartBrowserBeforeEachPage"><strong>RestartBrowserBeforeEachPage</strong></a>(self)</dt><dd><tt>Should the browser be restarted for the page?<br> |
| <br> |
| This returns true if the test needs to unconditionally restart the<br> |
| browser for each page. It may be called before the browser is started.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-RunNavigateSteps"><strong>RunNavigateSteps</strong></a>(self, page, tab)</dt><dd><tt>Navigates the tab to the page URL attribute.<br> |
| <br> |
| Runs the 'navigate_steps' page attribute as a compound action.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-StopBrowserAfterPage"><strong>StopBrowserAfterPage</strong></a>(self, browser, page)</dt><dd><tt>Should the browser be stopped after the page is run?<br> |
| <br> |
| This is called after a page is run to decide whether the browser needs to<br> |
| be stopped to clean up its state. If it is stopped, then it will be<br> |
| restarted to run the next page.<br> |
| <br> |
| A test that overrides this can look at both the page and the browser to<br> |
| decide whether it needs to stop the browser.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-TabForPage"><strong>TabForPage</strong></a>(self, page, browser)</dt><dd><tt>Override to select a different tab for the page. For instance, to<br> |
| create a new tab for every page, return browser.tabs.New().</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-ValidatePageSet"><strong>ValidatePageSet</strong></a>(self, page_set)</dt><dd><tt>Override to examine the page set before the test run. Useful for<br> |
| example to validate that the pageset can be used with the test.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-WillRunAction"><strong>WillRunAction</strong></a>(self, page, tab, action)</dt><dd><tt>Override to do operations before running the action on the page.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-WillRunActions"><strong>WillRunActions</strong></a>(self, page, tab)</dt><dd><tt>Override to do operations before running the actions on the page.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-WillRunPageRepeats"><strong>WillRunPageRepeats</strong></a>(self, page)</dt><dd><tt>Override to do operations before each page is iterated over.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-WillRunTest"><strong>WillRunTest</strong></a>(self, options)</dt><dd><tt>Override to do operations before the page set(s) are navigated.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-WillStartBrowser"><strong>WillStartBrowser</strong></a>(self, browser)</dt><dd><tt>Override to manipulate the browser environment before it launches.</tt></dd></dl> |
| |
| <hr> |
| Data descriptors inherited from <a href="telemetry.page.page_test.html#PageTest">telemetry.page.page_test.PageTest</a>:<br> |
| <dl><dt><strong>action_name_to_run</strong></dt> |
| </dl> |
| <dl><dt><strong>attempts</strong></dt> |
| <dd><tt>Maximum number of times test will be attempted.</tt></dd> |
| </dl> |
| <dl><dt><strong>clear_cache_before_each_run</strong></dt> |
| <dd><tt>When set to True, the browser's disk and memory cache will be cleared<br> |
| before each run.</tt></dd> |
| </dl> |
| <dl><dt><strong>close_tabs_before_run</strong></dt> |
| <dd><tt>When set to True, all tabs are closed before running the test for the<br> |
| first time.</tt></dd> |
| </dl> |
| <dl><dt><strong>discard_first_result</strong></dt> |
| <dd><tt>When set to True, the first run of the test is discarded. This is<br> |
| useful for cases where it's desirable to have some test resource cached so<br> |
| the first run of the test can warm things up.</tt></dd> |
| </dl> |
| <dl><dt><strong>max_errors</strong></dt> |
| <dd><tt>Maximum number of errors allowed for the page set.</tt></dd> |
| </dl> |
| <dl><dt><strong>max_failures</strong></dt> |
| <dd><tt>Maximum number of failures allowed for the page set.</tt></dd> |
| </dl> |
| <hr> |
| Class methods inherited from <a href="telemetry.core.command_line.html#ArgumentHandlerMixIn">telemetry.core.command_line.ArgumentHandlerMixIn</a>:<br> |
| <dl><dt><a name="RecordPage-AddCommandLineArgs"><strong>AddCommandLineArgs</strong></a>(cls, parser)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Override to accept custom command-line arguments.</tt></dd></dl> |
| |
| <dl><dt><a name="RecordPage-ProcessCommandLineArgs"><strong>ProcessCommandLineArgs</strong></a>(cls, parser, args)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Override to process command-line arguments.<br> |
| <br> |
| We pass in parser so we can call parser.error().</tt></dd></dl> |
| |
| <hr> |
| Data descriptors inherited from <a href="telemetry.core.command_line.html#ArgumentHandlerMixIn">telemetry.core.command_line.ArgumentHandlerMixIn</a>:<br> |
| <dl><dt><strong>__dict__</strong></dt> |
| <dd><tt>dictionary for instance variables (if defined)</tt></dd> |
| </dl> |
| <dl><dt><strong>__weakref__</strong></dt> |
| <dd><tt>list of weak references to the object (if defined)</tt></dd> |
| </dl> |
| </td></tr></table></td></tr></table><p> |
| <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> |
| <tr bgcolor="#eeaa77"> |
| <td colspan=3 valign=bottom> <br> |
| <font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr> |
| |
| <tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td> |
| <td width="100%"><dl><dt><a name="-Main"><strong>Main</strong></a>(base_dir)</dt></dl> |
| </td></tr></table> |
| </body></html> |