168 lines
11 KiB
HTML
168 lines
11 KiB
HTML
|
|
||
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||
|
|
<html><head><title>Python: module telemetry.core.tab</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.core.html"><font color="#ffffff">core</font></a>.tab</strong></big></big></font></td
|
||
|
|
><td align=right valign=bottom
|
||
|
|
><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="../telemetry/core/tab.py">telemetry/core/tab.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.web_contents.html">telemetry.core.web_contents</a><br>
|
||
|
|
</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></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.core.web_contents.html#WebContents">telemetry.core.web_contents.WebContents</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
|
||
|
|
</font></dt><dd>
|
||
|
|
<dl>
|
||
|
|
<dt><font face="helvetica, arial"><a href="telemetry.core.tab.html#Tab">Tab</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="Tab">class <strong>Tab</strong></a>(<a href="telemetry.core.web_contents.html#WebContents">telemetry.core.web_contents.WebContents</a>)</font></td></tr>
|
||
|
|
|
||
|
|
<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
|
||
|
|
<td colspan=2><tt>Represents a tab in the browser<br>
|
||
|
|
<br>
|
||
|
|
The important parts of the <a href="#Tab">Tab</a> object are in the runtime and page objects.<br>
|
||
|
|
E.g.:<br>
|
||
|
|
# Navigates the tab to a given url.<br>
|
||
|
|
tab.<a href="#Tab-Navigate">Navigate</a>('<a href="http://www.google.com/">http://www.google.com/</a>')<br>
|
||
|
|
<br>
|
||
|
|
# Evaluates 1+1 in the tab's JavaScript context.<br>
|
||
|
|
tab.Evaluate('1+1')<br> </tt></td></tr>
|
||
|
|
<tr><td> </td>
|
||
|
|
<td width="100%"><dl><dt>Method resolution order:</dt>
|
||
|
|
<dd><a href="telemetry.core.tab.html#Tab">Tab</a></dd>
|
||
|
|
<dd><a href="telemetry.core.web_contents.html#WebContents">telemetry.core.web_contents.WebContents</a></dd>
|
||
|
|
<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
|
||
|
|
</dl>
|
||
|
|
<hr>
|
||
|
|
Methods defined here:<br>
|
||
|
|
<dl><dt><a name="Tab-Activate"><strong>Activate</strong></a>(self)</dt><dd><tt>Brings this tab to the foreground asynchronously.<br>
|
||
|
|
<br>
|
||
|
|
Not all browsers or browser versions support this method.<br>
|
||
|
|
Be sure to check browser.supports_tab_control.<br>
|
||
|
|
<br>
|
||
|
|
Please note: this is asynchronous. There is a delay between this call<br>
|
||
|
|
and the page's documentVisibilityState becoming 'visible', and yet more<br>
|
||
|
|
delay until the actual tab is visible to the user. None of these delays<br>
|
||
|
|
are included in this call.</tt></dd></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-ClearCache"><strong>ClearCache</strong></a>(self)</dt><dd><tt>Clears the browser's HTTP disk cache and the tab's HTTP memory cache.</tt></dd></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-CollectGarbage"><strong>CollectGarbage</strong></a>(self)</dt></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-GetCookieByName"><strong>GetCookieByName</strong></a>(self, name, timeout<font color="#909090">=60</font>)</dt><dd><tt>Returns the value of the cookie by the given |name|.</tt></dd></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-Navigate"><strong>Navigate</strong></a>(self, url, script_to_evaluate_on_commit<font color="#909090">=None</font>, timeout<font color="#909090">=60</font>)</dt><dd><tt>Navigates to url.<br>
|
||
|
|
<br>
|
||
|
|
If |script_to_evaluate_on_commit| is given, the script source string will be<br>
|
||
|
|
evaluated when the navigation is committed. This is after the context of<br>
|
||
|
|
the page exists, but before any script on the page itself has executed.</tt></dd></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-PerformActionAndWaitForNavigate"><strong>PerformActionAndWaitForNavigate</strong></a>(self, action_function, timeout<font color="#909090">=60</font>)</dt><dd><tt>Executes action_function, and waits for the navigation to complete.<br>
|
||
|
|
<br>
|
||
|
|
action_function must be a Python function that results in a navigation.<br>
|
||
|
|
This function returns when the navigation is complete or when<br>
|
||
|
|
the timeout has been exceeded.</tt></dd></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-Screenshot"><strong>Screenshot</strong></a>(self, timeout<font color="#909090">=60</font>)</dt><dd><tt>Capture a screenshot of the window for rendering validation</tt></dd></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-__del__"><strong>__del__</strong></a>(self)</dt></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-__init__"><strong>__init__</strong></a>(self, inspector_backend)</dt></dl>
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
Data descriptors defined here:<br>
|
||
|
|
<dl><dt><strong>browser</strong></dt>
|
||
|
|
<dd><tt>The browser in which this tab resides.</tt></dd>
|
||
|
|
</dl>
|
||
|
|
<dl><dt><strong>dom_stats</strong></dt>
|
||
|
|
<dd><tt>A dictionary populated with measured DOM statistics.<br>
|
||
|
|
<br>
|
||
|
|
Currently this dictionary contains:<br>
|
||
|
|
{<br>
|
||
|
|
'document_count': integer,<br>
|
||
|
|
'node_count': integer,<br>
|
||
|
|
'event_listener_count': integer<br>
|
||
|
|
}</tt></dd>
|
||
|
|
</dl>
|
||
|
|
<dl><dt><strong>screenshot_supported</strong></dt>
|
||
|
|
<dd><tt>True if the browser instance is capable of capturing screenshots</tt></dd>
|
||
|
|
</dl>
|
||
|
|
<dl><dt><strong>url</strong></dt>
|
||
|
|
</dl>
|
||
|
|
<hr>
|
||
|
|
Methods inherited from <a href="telemetry.core.web_contents.html#WebContents">telemetry.core.web_contents.WebContents</a>:<br>
|
||
|
|
<dl><dt><a name="Tab-Close"><strong>Close</strong></a>(self)</dt><dd><tt>Closes this page.<br>
|
||
|
|
<br>
|
||
|
|
Not all browsers or browser versions support this method.<br>
|
||
|
|
Be sure to check browser.supports_tab_control.</tt></dd></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-Disconnect"><strong>Disconnect</strong></a>(self)</dt></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-EvaluateJavaScript"><strong>EvaluateJavaScript</strong></a>(self, expr, timeout<font color="#909090">=60</font>)</dt><dd><tt>Evalutes expr in JavaScript and returns the JSONized result.<br>
|
||
|
|
<br>
|
||
|
|
Consider using ExecuteJavaScript for cases where the result of the<br>
|
||
|
|
expression is not needed.<br>
|
||
|
|
<br>
|
||
|
|
If evaluation throws in JavaScript, a Python EvaluateException will<br>
|
||
|
|
be raised.<br>
|
||
|
|
<br>
|
||
|
|
If the result of the evaluation cannot be JSONized, then an<br>
|
||
|
|
EvaluationException will be raised.</tt></dd></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-ExecuteJavaScript"><strong>ExecuteJavaScript</strong></a>(self, expr, timeout<font color="#909090">=60</font>)</dt><dd><tt>Executes expr in JavaScript. Does not return the result.<br>
|
||
|
|
<br>
|
||
|
|
If the expression failed to evaluate, EvaluateException will be raised.</tt></dd></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-StartTimelineRecording"><strong>StartTimelineRecording</strong></a>(self)</dt></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-StopTimelineRecording"><strong>StopTimelineRecording</strong></a>(self)</dt></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-WaitForDocumentReadyStateToBeComplete"><strong>WaitForDocumentReadyStateToBeComplete</strong></a>(self, timeout<font color="#909090">=60</font>)</dt></dl>
|
||
|
|
|
||
|
|
<dl><dt><a name="Tab-WaitForDocumentReadyStateToBeInteractiveOrBetter"><strong>WaitForDocumentReadyStateToBeInteractiveOrBetter</strong></a>(self, timeout<font color="#909090">=60</font>)</dt></dl>
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
Data descriptors inherited from <a href="telemetry.core.web_contents.html#WebContents">telemetry.core.web_contents.WebContents</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>
|
||
|
|
<dl><dt><strong>message_output_stream</strong></dt>
|
||
|
|
</dl>
|
||
|
|
<dl><dt><strong>timeline_model</strong></dt>
|
||
|
|
</dl>
|
||
|
|
</td></tr></table></td></tr></table><p>
|
||
|
|
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
|
||
|
|
<tr bgcolor="#55aa55">
|
||
|
|
<td colspan=3 valign=bottom> <br>
|
||
|
|
<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
|
||
|
|
|
||
|
|
<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
|
||
|
|
<td width="100%"><strong>DEFAULT_TAB_TIMEOUT</strong> = 60</td></tr></table>
|
||
|
|
</body></html>
|