telemetry.core.tab
index
telemetry/core/tab.py

# Copyright (c) 2012 The Chromium Authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.

 
Modules
       
telemetry.core.web_contents

 
Classes
       
telemetry.core.web_contents.WebContents(__builtin__.object)
Tab

 
class Tab(telemetry.core.web_contents.WebContents)
    Represents a tab in the browser
 
The important parts of the Tab object are in the runtime and page objects.
E.g.:
    # Navigates the tab to a given url.
    tab.Navigate('http://www.google.com/')
 
    # Evaluates 1+1 in the tab's JavaScript context.
    tab.Evaluate('1+1')
 
 
Method resolution order:
Tab
telemetry.core.web_contents.WebContents
__builtin__.object

Methods defined here:
Activate(self)
Brings this tab to the foreground asynchronously.
 
Not all browsers or browser versions support this method.
Be sure to check browser.supports_tab_control.
 
Please note: this is asynchronous. There is a delay between this call
and the page's documentVisibilityState becoming 'visible', and yet more
delay until the actual tab is visible to the user. None of these delays
are included in this call.
ClearCache(self)
Clears the browser's HTTP disk cache and the tab's HTTP memory cache.
CollectGarbage(self)
GetCookieByName(self, name, timeout=60)
Returns the value of the cookie by the given |name|.
Navigate(self, url, script_to_evaluate_on_commit=None, timeout=60)
Navigates to url.
 
If |script_to_evaluate_on_commit| is given, the script source string will be
evaluated when the navigation is committed. This is after the context of
the page exists, but before any script on the page itself has executed.
PerformActionAndWaitForNavigate(self, action_function, timeout=60)
Executes action_function, and waits for the navigation to complete.
 
action_function must be a Python function that results in a navigation.
This function returns when the navigation is complete or when
the timeout has been exceeded.
Screenshot(self, timeout=60)
Capture a screenshot of the window for rendering validation
__del__(self)
__init__(self, inspector_backend)

Data descriptors defined here:
browser
The browser in which this tab resides.
dom_stats
A dictionary populated with measured DOM statistics.
 
Currently this dictionary contains:
{
  'document_count': integer,
  'node_count': integer,
  'event_listener_count': integer
}
screenshot_supported
True if the browser instance is capable of capturing screenshots
url

Methods inherited from telemetry.core.web_contents.WebContents:
Close(self)
Closes this page.
 
Not all browsers or browser versions support this method.
Be sure to check browser.supports_tab_control.
Disconnect(self)
EvaluateJavaScript(self, expr, timeout=60)
Evalutes expr in JavaScript and returns the JSONized result.
 
Consider using ExecuteJavaScript for cases where the result of the
expression is not needed.
 
If evaluation throws in JavaScript, a Python EvaluateException will
be raised.
 
If the result of the evaluation cannot be JSONized, then an
EvaluationException will be raised.
ExecuteJavaScript(self, expr, timeout=60)
Executes expr in JavaScript. Does not return the result.
 
If the expression failed to evaluate, EvaluateException will be raised.
StartTimelineRecording(self)
StopTimelineRecording(self)
WaitForDocumentReadyStateToBeComplete(self, timeout=60)
WaitForDocumentReadyStateToBeInteractiveOrBetter(self, timeout=60)

Data descriptors inherited from telemetry.core.web_contents.WebContents:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)
message_output_stream
timeline_model

 
Data
        DEFAULT_TAB_TIMEOUT = 60