Fetch info about the state of navigation in a tab

chrome/test/pyautolib/pyauto.py

 #!/usr/bin/python
 
 # Copyright (c) 2010 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.
 
 """PyAuto: Python Interface to Chromium's Automation Proxy.
 
 PyAuto uses swig to expose Automation Proxy interfaces to Python.
 For complete documentation on the functionality available,
@@ skipping 710 matching lines @@
                         u'y': 44}]}
 
     Raises:
       pyauto_errors.JSONInterfaceError if the automation call returns an error.
     """
     cmd_dict = {  # Prepare command for the json interface
       'command': 'GetBrowserInfo',
     }
     return self._GetResultFromJSONRequest(cmd_dict)
 
+  def GetNavigationInfo(self, tab_index=0, windex=0):
+    """Get info about the navigation state of a given tab.
+
+    Args:
+      tab_index: The tab index, default is 0.
+      window_index: The window index, default is 0.
+
+    Returns:
+      a dictionary.
+      Sample:
+
+      { u'favicon_url': u'https://www.google.com/favicon.ico',
+        u'page_type': u'NORMAL_PAGE',
+        u'ssl': { u'displayed_insecure_content': False,
+                  u'ran_insecure_content': False,
+                  u'security_style': u'SECURITY_STYLE_AUTHENTICATED'}}
+
+      Values for security_style can be:
+        SECURITY_STYLE_UNKNOWN
+        SECURITY_STYLE_UNAUTHENTICATED
+        SECURITY_STYLE_AUTHENTICATION_BROKEN
+        SECURITY_STYLE_AUTHENTICATED
+
+      Values for page_type can be:
+        NORMAL_PAGE
+        ERROR_PAGE
+        INTERSTITIAL_PAGE
+    """
+    cmd_dict = {  # Prepare command for the json interface
+      'command': 'GetNavigationInfo',
+      'tab_index': tab_index,
+    }
+    return self._GetResultFromJSONRequest(cmd_dict, windex=windex)
+
   def GetHistoryInfo(self, search_text=''):
     """Return info about browsing history.
 
     Args:
       search_text: the string to search in history.  Defaults to empty string
                    which means that all history would be returned. This is
                    functionally equivalent to searching for a text in the
                    chrome://history UI. So partial matches work too.
                    When non-empty, the history items returned will contain a
                    "snippet" field corresponding to the snippet visible in
@@ skipping 899 matching lines @@
     if self._options.verbose:
       verbosity = 2
     result = PyAutoTextTestRuner(verbosity=verbosity).run(pyauto_suite)
     del loaded_tests  # Need to destroy test cases before the suite
     del pyauto_suite
     sys.exit(not result.wasSuccessful())
 
 
 if __name__ == '__main__':
   Main()