tools/telemetry/docs/telemetry.page.record_wpr.html - Issue 196383034: Update telemetry docs by running the update_docs script.

Unified Diff: tools/telemetry/docs/telemetry.page.record_wpr.html

Issue 196383034: Update telemetry docs by running the update_docs script. (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src

Patch Set: Created 6 years, 9 months ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

View side-by-side diff with in-line comments

Download patch

Index: tools/telemetry/docs/telemetry.page.record_wpr.html

diff --git a/tools/telemetry/docs/telemetry.page.record_wpr.html b/tools/telemetry/docs/telemetry.page.record_wpr.html

index a82922f1f0fee00549d72beb96c3ddda5dda3854..d91dce38cace15e4c7e996dbf582a869686ed640 100644

--- a/tools/telemetry/docs/telemetry.page.record_wpr.html

+++ b/tools/telemetry/docs/telemetry.page.record_wpr.html

@@ -21,17 +21,23 @@

<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>

<a href="telemetry.core.discover.html">telemetry.core.discover</a>

+<a href="json.html">json</a>

<a href="logging.html">logging</a>

</td><td width="25%" valign=top><a href="telemetry.page.page_measurement.html">telemetry.page.page_measurement</a>

+<a href="telemetry.page.page_measurement_results.html">telemetry.page.page_measurement_results</a>

<a href="telemetry.page.page_runner.html">telemetry.page.page_runner</a>

<a href="telemetry.page.page_set.html">telemetry.page.page_set</a>

<a href="telemetry.page.page_test.html">telemetry.page.page_test</a>

-</td><td width="25%" valign=top><a href="sys.html">sys</a>

+</td><td width="25%" valign=top><a href="telemetry.page.profile_creator.html">telemetry.page.profile_creator</a>

+<a href="sys.html">sys</a>

<a href="tempfile.html">tempfile</a>

<a href="telemetry.test.html">telemetry.test</a>

-<a href="time.html">time</a>

-</td><td width="25%" valign=top><a href="telemetry.core.wpr_modes.html">telemetry.core.wpr_modes</a>

+<a href="telemetry.page.test_expectations.html">telemetry.page.test_expectations</a>

+</td><td width="25%" valign=top><a href="time.html">time</a>

+<a href="urlparse.html">urlparse</a>

+<a href="telemetry.core.util.html">telemetry.core.util</a>

+<a href="telemetry.core.wpr_modes.html">telemetry.core.wpr_modes</a>

</td></tr></table></td></tr></table>

@@ -40,7 +46,7 @@

-<dt><a href="telemetry.page.page_test.html#PageTest">telemetry.page.page_test.PageTest</a>(<a href="__builtin__.html#object">__builtin__.object</a>)

+<dt><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>)

</dt><dd>

<dl>

<dt><a href="telemetry.page.record_wpr.html#RecordPage">RecordPage</a>

@@ -57,76 +63,135 @@

<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:

<dl><dt><a name="RecordPage-CanRunForPage">CanRunForPage</a>(self, page)</dt></dl>

-<dl><dt><a name="RecordPage-CustomizeBrowserOptionsForPage">CustomizeBrowserOptionsForPage</a>(self, page, options)</dt></dl>

+<dl><dt><a name="RecordPage-CustomizeBrowserOptionsForPageSet">CustomizeBrowserOptionsForPageSet</a>(self, pset, options)</dt></dl>

-<dl><dt><a name="RecordPage-Run">Run</a>(self, options, page, tab, results)</dt></dl>

+<dl><dt><a name="RecordPage-DidNavigateToPage">DidNavigateToPage</a>(self, page, tab)</dt><dd><tt>Forward the call to the test.</tt></dd></dl>

+<dl><dt><a name="RecordPage-Run">Run</a>(self, page, tab, results)</dt></dl>

+<dl><dt><a name="RecordPage-WillNavigateToPage">WillNavigateToPage</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__">__init__</a>(self, measurements)</dt></dl>

<hr>

Methods inherited from <a href="telemetry.page.page_test.html#PageTest">telemetry.page.page_test.PageTest</a>:

-<dl><dt><a name="RecordPage-AddCommandLineOptions">AddCommandLineOptions</a>(self, parser)</dt><dd><tt>Override to expose command-line options for this test.

-

-The provided parser is an optparse.OptionParser instance and accepts all

-normal results. The parsed options are available in Run as

-self.options.</tt></dd></dl>

+<dl><dt><a name="RecordPage-CleanUpAfterPage">CleanUpAfterPage</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-AddOutputOptions">AddOutputOptions</a>(self, parser)</dt></dl>

+<dl><dt><a name="RecordPage-CreateExpectations">CreateExpectations</a>(self, page_set)</dt><dd><tt>Override to make this test generate its own expectations instead of

+any that may have been defined in the page set.</tt></dd></dl>

<dl><dt><a name="RecordPage-CreatePageSet">CreatePageSet</a>(self, args, options)</dt><dd><tt>Override to make this test generate its own page set instead of

allowing arbitrary page sets entered from the command-line.</tt></dd></dl>

<dl><dt><a name="RecordPage-CustomizeBrowserOptions">CustomizeBrowserOptions</a>(self, options)</dt><dd><tt>Override to add test-specific options to the BrowserOptions object</tt></dd></dl>

-<dl><dt><a name="RecordPage-DidNavigateToPage">DidNavigateToPage</a>(self, page, tab)</dt><dd><tt>Override to do operations right after the page is navigated, but before

-any waiting for completion has occurred.</tt></dd></dl>

+<dl><dt><a name="RecordPage-CustomizeBrowserOptionsForSinglePage">CustomizeBrowserOptionsForSinglePage</a>(self, page, options)</dt><dd><tt>Set options specific to the test and the given page.

+

+This will be called with the current page when the browser is (re)started.

+Changing options at this point only makes sense if the browser is being

+restarted for each page. Note that if page has a startup_url, the browser

+will always be restarted for each run.</tt></dd></dl>

<dl><dt><a name="RecordPage-DidRunAction">DidRunAction</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-DidRunPageSet">DidRunPageSet</a>(self, tab, results)</dt><dd><tt>Override to do operations after page set is completed, but before browser

-is torn down.</tt></dd></dl>

+<dl><dt><a name="RecordPage-DidRunActions">DidRunActions</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">DidRunPageRepeats</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">DidRunTest</a>(self, browser, results)</dt><dd><tt>Override to do operations after all page set(s) are completed.

+

+This will occur before the browser is torn down.</tt></dd></dl>

+<dl><dt><a name="RecordPage-DidStartBrowser">DidStartBrowser</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">DidStartHTTPServer</a>(self, tab)</dt><dd><tt>Override to do operations after the HTTP server is started.</tt></dd></dl>

-<dl><dt><a name="RecordPage-NeedsBrowserRestartAfterEachRun">NeedsBrowserRestartAfterEachRun</a>(self, tab)</dt><dd><tt>Override to specify browser restart after each run.</tt></dd></dl>

+<dl><dt><a name="RecordPage-IsExiting">IsExiting</a>(self)</dt></dl>

-<dl><dt><a name="RecordPage-PrepareResults">PrepareResults</a>(self, options)</dt></dl>

+<dl><dt><a name="RecordPage-RequestExit">RequestExit</a>(self)</dt></dl>

-<dl><dt><a name="RecordPage-SetUpBrowser">SetUpBrowser</a>(self, browser)</dt><dd><tt>Override to customize the browser right after it has launched.</tt></dd></dl>

+<dl><dt><a name="RecordPage-RestartBrowserBeforeEachPage">RestartBrowserBeforeEachPage</a>(self)</dt><dd><tt>Should the browser be restarted for the page?

+

+This returns true if the test needs to unconditionally restart the

+browser for each page. It may be called before the browser is started.</tt></dd></dl>

-<dl><dt><a name="RecordPage-WillNavigateToPage">WillNavigateToPage</a>(self, page, tab)</dt><dd><tt>Override to do operations before the page is navigated.</tt></dd></dl>

+<dl><dt><a name="RecordPage-RunNavigateSteps">RunNavigateSteps</a>(self, page, tab)</dt><dd><tt>Navigates the tab to the page URL attribute.

+

+Runs the 'navigate_steps' page attribute as a compound action.</tt></dd></dl>

+<dl><dt><a name="RecordPage-StopBrowserAfterPage">StopBrowserAfterPage</a>(self, browser, page)</dt><dd><tt>Should the browser be stopped after the page is run?

+

+This is called after a page is run to decide whether the browser needs to

+be stopped to clean up its state. If it is stopped, then it will be

+restarted to run the next page.

+

+A test that overrides this can look at both the page and the browser to

+decide whether it needs to stop the browser.</tt></dd></dl>

+<dl><dt><a name="RecordPage-TabForPage">TabForPage</a>(self, page, browser)</dt><dd><tt>Override to select a different tab for the page.  For instance, to

+create a new tab for every page, return browser.tabs.New().</tt></dd></dl>

+<dl><dt><a name="RecordPage-ValidatePageSet">ValidatePageSet</a>(self, page_set)</dt><dd><tt>Override to examine the page set before the test run.  Useful for

+example to validate that the pageset can be used with the test.</tt></dd></dl>

<dl><dt><a name="RecordPage-WillRunAction">WillRunAction</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-WillRunPageSet">WillRunPageSet</a>(self, tab)</dt><dd><tt>Override to do operations before the page set is navigated.</tt></dd></dl>

+<dl><dt><a name="RecordPage-WillRunActions">WillRunActions</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">WillRunPageRepeats</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">WillRunTest</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">WillStartBrowser</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>:

-<dl><dt>__dict__</dt>

-<dd><tt>dictionary for instance variables (if defined)</tt></dd>

-</dl>

-<dl><dt>__weakref__</dt>

-<dd><tt>list of weak references to the object (if defined)</tt></dd>

-</dl>

<dl><dt>action_name_to_run</dt>

</dl>

+<dl><dt>attempts</dt>

+<dd><tt>Maximum number of times test will be attempted.</tt></dd>

+</dl>

<dl><dt>clear_cache_before_each_run</dt>

<dd><tt>When set to True, the browser's disk and memory cache will be cleared

before each run.</tt></dd>

</dl>

+<dl><dt>close_tabs_before_run</dt>

+<dd><tt>When set to True, all tabs are closed before running the test for the

+first time.</tt></dd>

+</dl>

<dl><dt>discard_first_result</dt>

<dd><tt>When set to True, the first run of the test is discarded.  This is

useful for cases where it's desirable to have some test resource cached so

the first run of the test can warm things up.</tt></dd>

</dl>

-<dl><dt>output_format_choices</dt>

-<dd><tt>Allowed output formats. The default is the first item in the list.</tt></dd>

+<dl><dt>max_errors</dt>

+<dd><tt>Maximum number of errors allowed for the page set.</tt></dd>

+</dl>

+<dl><dt>max_failures</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>:

+<dl><dt><a name="RecordPage-AddCommandLineArgs">AddCommandLineArgs</a>(cls, parser) from <a href="__builtin__.html#type">__builtin__.type</a></dt><dd><tt>Override to accept custom command-line arguments.</tt></dd></dl>

+<dl><dt><a name="RecordPage-ProcessCommandLineArgs">ProcessCommandLineArgs</a>(cls, parser, args) from <a href="__builtin__.html#type">__builtin__.type</a></dt><dd><tt>Override to process command-line arguments.

+

+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>:

+<dl><dt>__dict__</dt>

+<dd><tt>dictionary for instance variables (if defined)</tt></dd>

+</dl>

+<dl><dt>__weakref__</dt>

+<dd><tt>list of weak references to the object (if defined)</tt></dd>

</dl>

</td></tr></table></td></tr></table>

« no previous file with comments | « tools/telemetry/docs/telemetry.page.perf_tests_helper.html ('k') | tools/telemetry/docs/telemetry.test.html » ('j') | no next file with comments »