1 2<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> 3<html><head><title>Python: module telemetry.internal.backends.chrome_inspector.inspector_websocket</title> 4<meta charset="utf-8"> 5</head><body bgcolor="#f0f0f8"> 6 7<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading"> 8<tr bgcolor="#7799ee"> 9<td valign=bottom> <br> 10<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="telemetry.html"><font color="#ffffff">telemetry</font></a>.<a href="telemetry.internal.html"><font color="#ffffff">internal</font></a>.<a href="telemetry.internal.backends.html"><font color="#ffffff">backends</font></a>.<a href="telemetry.internal.backends.chrome_inspector.html"><font color="#ffffff">chrome_inspector</font></a>.inspector_websocket</strong></big></big></font></td 11><td align=right valign=bottom 12><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="../telemetry/internal/backends/chrome_inspector/inspector_websocket.py">telemetry/internal/backends/chrome_inspector/inspector_websocket.py</a></font></td></tr></table> 13 <p><tt># Copyright 2014 The Chromium Authors. All rights reserved.<br> 14# Use of this source code is governed by a BSD-style license that can be<br> 15# found in the LICENSE file.</tt></p> 16<p> 17<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> 18<tr bgcolor="#aa55cc"> 19<td colspan=3 valign=bottom> <br> 20<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr> 21 22<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td> 23<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="errno.html">errno</a><br> 24<a href="telemetry.core.exceptions.html">telemetry.core.exceptions</a><br> 25</td><td width="25%" valign=top><a href="json.html">json</a><br> 26<a href="logging.html">logging</a><br> 27</td><td width="25%" valign=top><a href="socket.html">socket</a><br> 28<a href="time.html">time</a><br> 29</td><td width="25%" valign=top><a href="telemetry.internal.backends.chrome_inspector.websocket.html">telemetry.internal.backends.chrome_inspector.websocket</a><br> 30</td></tr></table></td></tr></table><p> 31<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> 32<tr bgcolor="#ee77aa"> 33<td colspan=3 valign=bottom> <br> 34<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr> 35 36<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td> 37<td width="100%"><dl> 38<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a> 39</font></dt><dd> 40<dl> 41<dt><font face="helvetica, arial"><a href="telemetry.internal.backends.chrome_inspector.inspector_websocket.html#InspectorWebsocket">InspectorWebsocket</a> 42</font></dt></dl> 43</dd> 44<dt><font face="helvetica, arial"><a href="telemetry.core.exceptions.html#Error">telemetry.core.exceptions.Error</a>(<a href="exceptions.html#Exception">exceptions.Exception</a>) 45</font></dt><dd> 46<dl> 47<dt><font face="helvetica, arial"><a href="telemetry.internal.backends.chrome_inspector.inspector_websocket.html#WebSocketDisconnected">WebSocketDisconnected</a> 48</font></dt></dl> 49</dd> 50</dl> 51 <p> 52<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> 53<tr bgcolor="#ffc8d8"> 54<td colspan=3 valign=bottom> <br> 55<font color="#000000" face="helvetica, arial"><a name="InspectorWebsocket">class <strong>InspectorWebsocket</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr> 56 57<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td> 58<td width="100%">Methods defined here:<br> 59<dl><dt><a name="InspectorWebsocket-AsyncRequest"><strong>AsyncRequest</strong></a>(self, req, callback)</dt><dd><tt>Sends an async request and returns immediately.<br> 60 <br> 61Response will be handled in the |callback| later when DispatchNotifications<br> 62is invoked.<br> 63 <br> 64Args:<br> 65 callback: a function that takes inspector's response as the argument.</tt></dd></dl> 66 67<dl><dt><a name="InspectorWebsocket-Connect"><strong>Connect</strong></a>(self, url, timeout<font color="#909090">=10</font>)</dt><dd><tt>Connects the websocket.<br> 68 <br> 69Raises:<br> 70 websocket.WebSocketException<br> 71 socket.error</tt></dd></dl> 72 73<dl><dt><a name="InspectorWebsocket-Disconnect"><strong>Disconnect</strong></a>(self)</dt><dd><tt>Disconnects the inspector websocket.<br> 74 <br> 75Raises:<br> 76 websocket.WebSocketException<br> 77 socket.error</tt></dd></dl> 78 79<dl><dt><a name="InspectorWebsocket-DispatchNotifications"><strong>DispatchNotifications</strong></a>(self, timeout<font color="#909090">=10</font>)</dt><dd><tt>Waits for responses from the websocket, dispatching them as necessary.<br> 80 <br> 81Raises:<br> 82 websocket.WebSocketException: <a href="telemetry.core.exceptions.html#Error">Error</a> from websocket library.<br> 83 socket.error: <a href="telemetry.core.exceptions.html#Error">Error</a> from websocket library.<br> 84 exceptions.<a href="#WebSocketDisconnected">WebSocketDisconnected</a>: The socket was disconnected.</tt></dd></dl> 85 86<dl><dt><a name="InspectorWebsocket-RegisterDomain"><strong>RegisterDomain</strong></a>(self, domain_name, notification_handler)</dt><dd><tt>Registers a given domain for handling notification methods.<br> 87 <br> 88For example, given inspector_backend:<br> 89 def OnConsoleNotification(msg):<br> 90 if msg['method'] == 'Console.messageAdded':<br> 91 print msg['params']['message']<br> 92 inspector_backend.<a href="#InspectorWebsocket-RegisterDomain">RegisterDomain</a>('Console', OnConsoleNotification)<br> 93 <br> 94Args:<br> 95 domain_name: The devtools domain name. E.g., 'Tracing', 'Memory', 'Page'.<br> 96 notification_handler: Handler for devtools notification. Will be<br> 97 called if a devtools notification with matching domain is received<br> 98 via DispatchNotifications. The handler accepts a single paramater:<br> 99 the JSON <a href="__builtin__.html#object">object</a> representing the notification.</tt></dd></dl> 100 101<dl><dt><a name="InspectorWebsocket-SendAndIgnoreResponse"><strong>SendAndIgnoreResponse</strong></a>(self, req)</dt><dd><tt>Sends a request without waiting for a response.<br> 102 <br> 103Raises:<br> 104 websocket.WebSocketException: <a href="telemetry.core.exceptions.html#Error">Error</a> from websocket library.<br> 105 socket.error: <a href="telemetry.core.exceptions.html#Error">Error</a> from websocket library.<br> 106 exceptions.<a href="#WebSocketDisconnected">WebSocketDisconnected</a>: The socket was disconnected.</tt></dd></dl> 107 108<dl><dt><a name="InspectorWebsocket-SyncRequest"><strong>SyncRequest</strong></a>(self, req, timeout<font color="#909090">=10</font>)</dt><dd><tt>Sends a request and waits for a response.<br> 109 <br> 110Raises:<br> 111 websocket.WebSocketException: <a href="telemetry.core.exceptions.html#Error">Error</a> from websocket library.<br> 112 socket.error: <a href="telemetry.core.exceptions.html#Error">Error</a> from websocket library.<br> 113 exceptions.<a href="#WebSocketDisconnected">WebSocketDisconnected</a>: The socket was disconnected.</tt></dd></dl> 114 115<dl><dt><a name="InspectorWebsocket-UnregisterDomain"><strong>UnregisterDomain</strong></a>(self, domain_name)</dt><dd><tt>Unregisters a previously registered domain.</tt></dd></dl> 116 117<dl><dt><a name="InspectorWebsocket-__init__"><strong>__init__</strong></a>(self)</dt><dd><tt>Create a websocket handler for communicating with Inspectors.</tt></dd></dl> 118 119<hr> 120Data descriptors defined here:<br> 121<dl><dt><strong>__dict__</strong></dt> 122<dd><tt>dictionary for instance variables (if defined)</tt></dd> 123</dl> 124<dl><dt><strong>__weakref__</strong></dt> 125<dd><tt>list of weak references to the object (if defined)</tt></dd> 126</dl> 127<hr> 128Data and other attributes defined here:<br> 129<dl><dt><strong>METHOD_NOT_FOUND_CODE</strong> = -32601</dl> 130 131</td></tr></table> <p> 132<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section"> 133<tr bgcolor="#ffc8d8"> 134<td colspan=3 valign=bottom> <br> 135<font color="#000000" face="helvetica, arial"><a name="WebSocketDisconnected">class <strong>WebSocketDisconnected</strong></a>(<a href="telemetry.core.exceptions.html#Error">telemetry.core.exceptions.Error</a>)</font></td></tr> 136 137<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td> 138<td colspan=2><tt>An attempt was made to use a web socket after it had been disconnected.<br> </tt></td></tr> 139<tr><td> </td> 140<td width="100%"><dl><dt>Method resolution order:</dt> 141<dd><a href="telemetry.internal.backends.chrome_inspector.inspector_websocket.html#WebSocketDisconnected">WebSocketDisconnected</a></dd> 142<dd><a href="telemetry.core.exceptions.html#Error">telemetry.core.exceptions.Error</a></dd> 143<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd> 144<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd> 145<dd><a href="__builtin__.html#object">__builtin__.object</a></dd> 146</dl> 147<hr> 148Methods inherited from <a href="telemetry.core.exceptions.html#Error">telemetry.core.exceptions.Error</a>:<br> 149<dl><dt><a name="WebSocketDisconnected-AddDebuggingMessage"><strong>AddDebuggingMessage</strong></a>(self, msg)</dt><dd><tt>Adds a message to the description of the exception.<br> 150 <br> 151Many Telemetry exceptions arise from failures in another application. These<br> 152failures are difficult to pinpoint. This method allows Telemetry classes to<br> 153append useful debugging information to the exception. This method also logs<br> 154information about the location from where it was called.</tt></dd></dl> 155 156<dl><dt><a name="WebSocketDisconnected-__init__"><strong>__init__</strong></a>(self, msg<font color="#909090">=''</font>)</dt></dl> 157 158<dl><dt><a name="WebSocketDisconnected-__str__"><strong>__str__</strong></a>(self)</dt></dl> 159 160<hr> 161Data descriptors inherited from <a href="telemetry.core.exceptions.html#Error">telemetry.core.exceptions.Error</a>:<br> 162<dl><dt><strong>__weakref__</strong></dt> 163<dd><tt>list of weak references to the object (if defined)</tt></dd> 164</dl> 165<hr> 166Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br> 167<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#WebSocketDisconnected-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl> 168 169<hr> 170Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> 171<dl><dt><a name="WebSocketDisconnected-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#WebSocketDisconnected-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl> 172 173<dl><dt><a name="WebSocketDisconnected-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#WebSocketDisconnected-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl> 174 175<dl><dt><a name="WebSocketDisconnected-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#WebSocketDisconnected-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl> 176 177<dl><dt><a name="WebSocketDisconnected-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#WebSocketDisconnected-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br> 178 <br> 179Use of negative indices is not supported.</tt></dd></dl> 180 181<dl><dt><a name="WebSocketDisconnected-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl> 182 183<dl><dt><a name="WebSocketDisconnected-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#WebSocketDisconnected-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl> 184 185<dl><dt><a name="WebSocketDisconnected-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#WebSocketDisconnected-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl> 186 187<dl><dt><a name="WebSocketDisconnected-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl> 188 189<dl><dt><a name="WebSocketDisconnected-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl> 190 191<hr> 192Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br> 193<dl><dt><strong>__dict__</strong></dt> 194</dl> 195<dl><dt><strong>args</strong></dt> 196</dl> 197<dl><dt><strong>message</strong></dt> 198</dl> 199</td></tr></table></td></tr></table> 200</body></html>