Adds function for activating a tab.

tools/telemetry/telemetry/browser_backend.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.
 
 import urllib2
 import httplib
 import socket
 import json
 import re
 import weakref
@@ skipping 25 matching lines @@
     self._UpdateTabList()
 
   def New(self, timeout=None):
     self._browser_backend.Request('new', timeout=timeout)
     return self[-1]
 
   def DoesDebuggerUrlExist(self, url):
     self._UpdateTabList()
     return url in self._tab_list
 
+  def ActivateTab(self, debugger_url, timeout=None):
+    """Activates a tab.
+

[nduca, 2012/12/21 22:15:23]

This doesn't make sense on the tab controller.

browser.tabs[2].Activate should be how this works.

[Danh Nguyen, 2012/12/26 19:13:04]

Done.

[Danh Nguyen, 2012/12/26 19:13:04]

Done.  I'm moving this function to tab.py as you suggested.

[dtu, 2012/12/27 18:57:25]

This is actually similar to how Close() works. tab.Close() calls
_tab_controller.CloseTab(), because TabController has a lot of the other logic
needed for CloseTab()

+    Args:
+      debugger_url: webSocketDebuggerUrl of the tab.
+    """
+    tab_id = debugger_url.split('/')[-1]
+    try:
+      response = self._browser_backend.Request('activate/%s' % tab_id,
+                                               timeout=timeout)
+    except urllib2.HTTPError:
+      raise Exception('Unable to activate tab, tab id not found: %s' % tab_id)
+    assert response == 'Target activated'
+    self._UpdateTabList()
+
   def CloseTab(self, debugger_url, timeout=None):
     # TODO(dtu): crbug.com/160946, allow closing the last tab on some platforms.
     # For now, just create a new tab before closing the last tab.
     if len(self) <= 1:
       self.New()
 
     tab_id = debugger_url.split('/')[-1]
     try:
       response = self._browser_backend.Request('close/%s' % tab_id,
                                                timeout=timeout)
@@ skipping 155 matching lines @@
     return self._tracing_backend.GetTraceAndReset()
 
   def CreateForwarder(self, host_port):
     raise NotImplementedError()
 
   def IsBrowserRunning(self):
     raise NotImplementedError()
 
   def GetStandardOutput(self):
     raise NotImplementedError()