Home | History | Annotate | Download | only in docs
      1 
      2 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
      3 <html><head><title>Python: module telemetry.core.browser</title>
      4 </head><body bgcolor="#f0f0f8">
      5 
      6 <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
      7 <tr bgcolor="#7799ee">
      8 <td valign=bottom>&nbsp;<br>
      9 <font color="#ffffff" face="helvetica, arial">&nbsp;<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>.browser</strong></big></big></font></td
     10 ><td align=right valign=bottom
     11 ><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="../telemetry/core/browser.py">telemetry/core/browser.py</a></font></td></tr></table>
     12     <p><tt>#&nbsp;Copyright&nbsp;(c)&nbsp;2012&nbsp;The&nbsp;Chromium&nbsp;Authors.&nbsp;All&nbsp;rights&nbsp;reserved.<br>
     13 #&nbsp;Use&nbsp;of&nbsp;this&nbsp;source&nbsp;code&nbsp;is&nbsp;governed&nbsp;by&nbsp;a&nbsp;BSD-style&nbsp;license&nbsp;that&nbsp;can&nbsp;be<br>
     14 #&nbsp;found&nbsp;in&nbsp;the&nbsp;LICENSE&nbsp;file.</tt></p>
     15 <p>
     16 <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
     17 <tr bgcolor="#aa55cc">
     18 <td colspan=3 valign=bottom>&nbsp;<br>
     19 <font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
     20     
     21 <tr><td bgcolor="#aa55cc"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
     22 <td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="telemetry.core.backends.browser_backend.html">telemetry.core.backends.browser_backend</a><br>
     23 <a href="telemetry.core.browser_credentials.html">telemetry.core.browser_credentials</a><br>
     24 <a href="telemetry.decorators.html">telemetry.decorators</a><br>
     25 <a href="telemetry.core.exceptions.html">telemetry.core.exceptions</a><br>
     26 </td><td width="25%" valign=top><a href="telemetry.core.extension_dict.html">telemetry.core.extension_dict</a><br>
     27 <a href="telemetry.core.local_server.html">telemetry.core.local_server</a><br>
     28 <a href="telemetry.core.memory_cache_http_server.html">telemetry.core.memory_cache_http_server</a><br>
     29 <a href="os.html">os</a><br>
     30 </td><td width="25%" valign=top><a href="telemetry.core.platform.html">telemetry.core.platform</a><br>
     31 <a href="telemetry.core.platform.profiler.profiler_finder.html">telemetry.core.platform.profiler.profiler_finder</a><br>
     32 <a href="telemetry.core.tab_list.html">telemetry.core.tab_list</a><br>
     33 <a href="telemetry.core.wpr_modes.html">telemetry.core.wpr_modes</a><br>
     34 </td><td width="25%" valign=top><a href="telemetry.core.wpr_server.html">telemetry.core.wpr_server</a><br>
     35 </td></tr></table></td></tr></table><p>
     36 <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
     37 <tr bgcolor="#ee77aa">
     38 <td colspan=3 valign=bottom>&nbsp;<br>
     39 <font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
     40     
     41 <tr><td bgcolor="#ee77aa"><tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</tt></td><td>&nbsp;</td>
     42 <td width="100%"><dl>
     43 <dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
     44 </font></dt><dd>
     45 <dl>
     46 <dt><font face="helvetica, arial"><a href="telemetry.core.browser.html#Browser">Browser</a>
     47 </font></dt></dl>
     48 </dd>
     49 </dl>
     50  <p>
     51 <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
     52 <tr bgcolor="#ffc8d8">
     53 <td colspan=3 valign=bottom>&nbsp;<br>
     54 <font color="#000000" face="helvetica, arial"><a name="Browser">class <strong>Browser</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
     55     
     56 <tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
     57 <td colspan=2><tt>A&nbsp;running&nbsp;browser&nbsp;instance&nbsp;that&nbsp;can&nbsp;be&nbsp;controlled&nbsp;in&nbsp;a&nbsp;limited&nbsp;way.<br>
     58 &nbsp;<br>
     59 To&nbsp;create&nbsp;a&nbsp;browser&nbsp;instance,&nbsp;use&nbsp;browser_finder.FindBrowser.<br>
     60 &nbsp;<br>
     61 Be&nbsp;sure&nbsp;to&nbsp;clean&nbsp;up&nbsp;after&nbsp;yourself&nbsp;by&nbsp;calling&nbsp;<a href="#Browser-Close">Close</a>()&nbsp;when&nbsp;you&nbsp;are&nbsp;done&nbsp;with<br>
     62 the&nbsp;browser.&nbsp;Or&nbsp;better&nbsp;yet:<br>
     63 &nbsp;&nbsp;browser_to_create&nbsp;=&nbsp;FindBrowser(options)<br>
     64 &nbsp;&nbsp;with&nbsp;browser_to_create.Create()&nbsp;as&nbsp;browser:<br>
     65 &nbsp;&nbsp;&nbsp;&nbsp;...&nbsp;do&nbsp;all&nbsp;your&nbsp;operations&nbsp;on&nbsp;browser&nbsp;here<br>&nbsp;</tt></td></tr>
     66 <tr><td>&nbsp;</td>
     67 <td width="100%">Methods defined here:<br>
     68 <dl><dt><a name="Browser-Close"><strong>Close</strong></a>(self)</dt><dd><tt>Closes&nbsp;this&nbsp;browser.</tt></dd></dl>
     69 
     70 <dl><dt><a name="Browser-GetStackTrace"><strong>GetStackTrace</strong></a>(self)</dt></dl>
     71 
     72 <dl><dt><a name="Browser-GetStandardOutput"><strong>GetStandardOutput</strong></a>(self)</dt></dl>
     73 
     74 <dl><dt><a name="Browser-GetSystemInfo"><strong>GetSystemInfo</strong></a>(self)</dt><dd><tt>Returns&nbsp;low-level&nbsp;information&nbsp;about&nbsp;the&nbsp;system,&nbsp;if&nbsp;available.<br>
     75 &nbsp;<br>
     76 See&nbsp;the&nbsp;documentation&nbsp;of&nbsp;the&nbsp;SystemInfo&nbsp;class&nbsp;for&nbsp;more&nbsp;details.</tt></dd></dl>
     77 
     78 <dl><dt><a name="Browser-SetHTTPServerDirectories"><strong>SetHTTPServerDirectories</strong></a>(self, paths)</dt><dd><tt>Returns&nbsp;True&nbsp;if&nbsp;the&nbsp;HTTP&nbsp;server&nbsp;was&nbsp;started,&nbsp;False&nbsp;otherwise.</tt></dd></dl>
     79 
     80 <dl><dt><a name="Browser-SetReplayArchivePath"><strong>SetReplayArchivePath</strong></a>(self, archive_path, append_to_existing_wpr<font color="#909090">=False</font>, make_javascript_deterministic<font color="#909090">=True</font>)</dt></dl>
     81 
     82 <dl><dt><a name="Browser-Start"><strong>Start</strong></a>(self)</dt></dl>
     83 
     84 <dl><dt><a name="Browser-StartLocalServer"><strong>StartLocalServer</strong></a>(self, server)</dt><dd><tt>Starts&nbsp;a&nbsp;LocalServer&nbsp;and&nbsp;associates&nbsp;it&nbsp;with&nbsp;this&nbsp;browser.<br>
     85 &nbsp;<br>
     86 It&nbsp;will&nbsp;be&nbsp;closed&nbsp;when&nbsp;the&nbsp;browser&nbsp;closes.</tt></dd></dl>
     87 
     88 <dl><dt><a name="Browser-StartProfiling"><strong>StartProfiling</strong></a>(self, profiler_name, base_output_file)</dt><dd><tt>Starts&nbsp;profiling&nbsp;using&nbsp;|profiler_name|.&nbsp;Results&nbsp;are&nbsp;saved&nbsp;to<br>
     89 |base_output_file|.&lt;process_name&gt;.</tt></dd></dl>
     90 
     91 <dl><dt><a name="Browser-StartTracing"><strong>StartTracing</strong></a>(self, custom_categories<font color="#909090">=None</font>, timeout<font color="#909090">=10</font>)</dt></dl>
     92 
     93 <dl><dt><a name="Browser-StopProfiling"><strong>StopProfiling</strong></a>(self)</dt><dd><tt>Stops&nbsp;all&nbsp;active&nbsp;profilers&nbsp;and&nbsp;saves&nbsp;their&nbsp;results.<br>
     94 &nbsp;<br>
     95 Returns:<br>
     96 &nbsp;&nbsp;A&nbsp;list&nbsp;of&nbsp;filenames&nbsp;produced&nbsp;by&nbsp;the&nbsp;profiler.</tt></dd></dl>
     97 
     98 <dl><dt><a name="Browser-StopTracing"><strong>StopTracing</strong></a>(self)</dt><dd><tt>Stops&nbsp;tracing&nbsp;and&nbsp;returns&nbsp;the&nbsp;result&nbsp;as&nbsp;TimelineData&nbsp;<a href="__builtin__.html#object">object</a>.</tt></dd></dl>
     99 
    100 <dl><dt><a name="Browser-__enter__"><strong>__enter__</strong></a>(self)</dt></dl>
    101 
    102 <dl><dt><a name="Browser-__exit__"><strong>__exit__</strong></a>(self, *args)</dt></dl>
    103 
    104 <dl><dt><a name="Browser-__init__"><strong>__init__</strong></a>(self, backend, platform_backend)</dt></dl>
    105 
    106 <dl><dt><a name="Browser-is_profiler_active"><strong>is_profiler_active</strong></a>(self, profiler_name)</dt></dl>
    107 
    108 <hr>
    109 Data descriptors defined here:<br>
    110 <dl><dt><strong>__dict__</strong></dt>
    111 <dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
    112 </dl>
    113 <dl><dt><strong>__weakref__</strong></dt>
    114 <dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
    115 </dl>
    116 <dl><dt><strong>browser_type</strong></dt>
    117 </dl>
    118 <dl><dt><strong>cpu_stats</strong></dt>
    119 <dd><tt>Returns&nbsp;a&nbsp;dict&nbsp;of&nbsp;cpu&nbsp;statistics&nbsp;for&nbsp;the&nbsp;system.<br>
    120 {&nbsp;'Browser':&nbsp;{<br>
    121 &nbsp;&nbsp;&nbsp;&nbsp;'CpuProcessTime':&nbsp;S,<br>
    122 &nbsp;&nbsp;&nbsp;&nbsp;'TotalTime':&nbsp;T<br>
    123 &nbsp;&nbsp;},<br>
    124 &nbsp;&nbsp;'Gpu':&nbsp;{<br>
    125 &nbsp;&nbsp;&nbsp;&nbsp;'CpuProcessTime':&nbsp;S,<br>
    126 &nbsp;&nbsp;&nbsp;&nbsp;'TotalTime':&nbsp;T<br>
    127 &nbsp;&nbsp;},<br>
    128 &nbsp;&nbsp;'Renderer':&nbsp;{<br>
    129 &nbsp;&nbsp;&nbsp;&nbsp;'CpuProcessTime':&nbsp;S,<br>
    130 &nbsp;&nbsp;&nbsp;&nbsp;'TotalTime':&nbsp;T<br>
    131 &nbsp;&nbsp;}<br>
    132 }<br>
    133 Any&nbsp;of&nbsp;the&nbsp;above&nbsp;keys&nbsp;may&nbsp;be&nbsp;missing&nbsp;on&nbsp;a&nbsp;per-platform&nbsp;basis.</tt></dd>
    134 </dl>
    135 <dl><dt><strong>extensions</strong></dt>
    136 </dl>
    137 <dl><dt><strong>foreground_tab</strong></dt>
    138 </dl>
    139 <dl><dt><strong>http_server</strong></dt>
    140 </dl>
    141 <dl><dt><strong>io_stats</strong></dt>
    142 <dd><tt>Returns&nbsp;a&nbsp;dict&nbsp;of&nbsp;IO&nbsp;statistics&nbsp;for&nbsp;the&nbsp;browser:<br>
    143 {&nbsp;'Browser':&nbsp;{<br>
    144 &nbsp;&nbsp;&nbsp;&nbsp;'ReadOperationCount':&nbsp;W,<br>
    145 &nbsp;&nbsp;&nbsp;&nbsp;'WriteOperationCount':&nbsp;X,<br>
    146 &nbsp;&nbsp;&nbsp;&nbsp;'ReadTransferCount':&nbsp;Y,<br>
    147 &nbsp;&nbsp;&nbsp;&nbsp;'WriteTransferCount':&nbsp;Z<br>
    148 &nbsp;&nbsp;},<br>
    149 &nbsp;&nbsp;'Gpu':&nbsp;{<br>
    150 &nbsp;&nbsp;&nbsp;&nbsp;'ReadOperationCount':&nbsp;W,<br>
    151 &nbsp;&nbsp;&nbsp;&nbsp;'WriteOperationCount':&nbsp;X,<br>
    152 &nbsp;&nbsp;&nbsp;&nbsp;'ReadTransferCount':&nbsp;Y,<br>
    153 &nbsp;&nbsp;&nbsp;&nbsp;'WriteTransferCount':&nbsp;Z<br>
    154 &nbsp;&nbsp;},<br>
    155 &nbsp;&nbsp;'Renderer':&nbsp;{<br>
    156 &nbsp;&nbsp;&nbsp;&nbsp;'ReadOperationCount':&nbsp;W,<br>
    157 &nbsp;&nbsp;&nbsp;&nbsp;'WriteOperationCount':&nbsp;X,<br>
    158 &nbsp;&nbsp;&nbsp;&nbsp;'ReadTransferCount':&nbsp;Y,<br>
    159 &nbsp;&nbsp;&nbsp;&nbsp;'WriteTransferCount':&nbsp;Z<br>
    160 &nbsp;&nbsp;}<br>
    161 }</tt></dd>
    162 </dl>
    163 <dl><dt><strong>is_content_shell</strong></dt>
    164 <dd><tt>Returns&nbsp;whether&nbsp;this&nbsp;browser&nbsp;is&nbsp;a&nbsp;content&nbsp;shell,&nbsp;only.</tt></dd>
    165 </dl>
    166 <dl><dt><strong>is_tracing_running</strong></dt>
    167 </dl>
    168 <dl><dt><strong>local_servers</strong></dt>
    169 <dd><tt>Returns&nbsp;the&nbsp;currently&nbsp;running&nbsp;local&nbsp;servers.</tt></dd>
    170 </dl>
    171 <dl><dt><strong>memory_stats</strong></dt>
    172 <dd><tt>Returns&nbsp;a&nbsp;dict&nbsp;of&nbsp;memory&nbsp;statistics&nbsp;for&nbsp;the&nbsp;browser:<br>
    173 {&nbsp;'Browser':&nbsp;{<br>
    174 &nbsp;&nbsp;&nbsp;&nbsp;'VM':&nbsp;R,<br>
    175 &nbsp;&nbsp;&nbsp;&nbsp;'VMPeak':&nbsp;S,<br>
    176 &nbsp;&nbsp;&nbsp;&nbsp;'WorkingSetSize':&nbsp;T,<br>
    177 &nbsp;&nbsp;&nbsp;&nbsp;'WorkingSetSizePeak':&nbsp;U,<br>
    178 &nbsp;&nbsp;&nbsp;&nbsp;'ProportionalSetSize':&nbsp;V,<br>
    179 &nbsp;&nbsp;&nbsp;&nbsp;'PrivateDirty':&nbsp;W<br>
    180 &nbsp;&nbsp;},<br>
    181 &nbsp;&nbsp;'Gpu':&nbsp;{<br>
    182 &nbsp;&nbsp;&nbsp;&nbsp;'VM':&nbsp;R,<br>
    183 &nbsp;&nbsp;&nbsp;&nbsp;'VMPeak':&nbsp;S,<br>
    184 &nbsp;&nbsp;&nbsp;&nbsp;'WorkingSetSize':&nbsp;T,<br>
    185 &nbsp;&nbsp;&nbsp;&nbsp;'WorkingSetSizePeak':&nbsp;U,<br>
    186 &nbsp;&nbsp;&nbsp;&nbsp;'ProportionalSetSize':&nbsp;V,<br>
    187 &nbsp;&nbsp;&nbsp;&nbsp;'PrivateDirty':&nbsp;W<br>
    188 &nbsp;&nbsp;},<br>
    189 &nbsp;&nbsp;'Renderer':&nbsp;{<br>
    190 &nbsp;&nbsp;&nbsp;&nbsp;'VM':&nbsp;R,<br>
    191 &nbsp;&nbsp;&nbsp;&nbsp;'VMPeak':&nbsp;S,<br>
    192 &nbsp;&nbsp;&nbsp;&nbsp;'WorkingSetSize':&nbsp;T,<br>
    193 &nbsp;&nbsp;&nbsp;&nbsp;'WorkingSetSizePeak':&nbsp;U,<br>
    194 &nbsp;&nbsp;&nbsp;&nbsp;'ProportionalSetSize':&nbsp;V,<br>
    195 &nbsp;&nbsp;&nbsp;&nbsp;'PrivateDirty':&nbsp;W<br>
    196 &nbsp;&nbsp;},<br>
    197 &nbsp;&nbsp;'SystemCommitCharge':&nbsp;X,<br>
    198 &nbsp;&nbsp;'SystemTotalPhysicalMemory':&nbsp;Y,<br>
    199 &nbsp;&nbsp;'ProcessCount':&nbsp;Z,<br>
    200 }<br>
    201 Any&nbsp;of&nbsp;the&nbsp;above&nbsp;keys&nbsp;may&nbsp;be&nbsp;missing&nbsp;on&nbsp;a&nbsp;per-platform&nbsp;basis.</tt></dd>
    202 </dl>
    203 <dl><dt><strong>platform</strong></dt>
    204 </dl>
    205 <dl><dt><strong>supports_extensions</strong></dt>
    206 </dl>
    207 <dl><dt><strong>supports_system_info</strong></dt>
    208 </dl>
    209 <dl><dt><strong>supports_tab_control</strong></dt>
    210 </dl>
    211 <dl><dt><strong>supports_tracing</strong></dt>
    212 </dl>
    213 <dl><dt><strong>synthetic_gesture_source_type</strong></dt>
    214 </dl>
    215 <dl><dt><strong>tabs</strong></dt>
    216 </dl>
    217 </td></tr></table></td></tr></table>
    218 </body></html>