Record event activity to the extension activity log.

chrome/browser/extensions/activity_log.h

 // 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.
 
 #ifndef CHROME_BROWSER_EXTENSIONS_ACTIVITY_LOG_H_
 #define CHROME_BROWSER_EXTENSIONS_ACTIVITY_LOG_H_
 
 #include <map>
 #include <string>
 #include <vector>
@@ skipping 18 matching lines @@
 class Extension;
 
 // A utility for tracing interesting activity for each extension.
 // It writes to an ActivityDatabase on a separate thread to record the activity.
 class ActivityLog : public ProfileKeyedService,
                     public TabHelper::ScriptExecutionObserver {
  public:
   enum Activity {
     ACTIVITY_EXTENSION_API_CALL,   // Extension API invocation is called.
     ACTIVITY_EXTENSION_API_BLOCK,  // Extension API invocation is blocked.
-    ACTIVITY_CONTENT_SCRIPT        // Content script is executing.
+    ACTIVITY_CONTENT_SCRIPT,       // Content script is executing.
+    ACTIVITY_EVENT_DISPATCH,       // Event sent to listener in extension.
   };
 
   // Observers can listen for activity events.
   class Observer {
    public:
     virtual void OnExtensionActivity(
         const Extension* extension,
         Activity activity,
         const std::string& message) = 0;
   };
 
   // ActivityLog is a singleton, so don't instantiate it with the constructor;
   // use GetInstance instead.
   static ActivityLog* GetInstance(Profile* profile);
 
   // Currently, we only want to record actions if the user has opted in to the
   // ActivityLog feature.
-  bool IsLoggingEnabled();
+  static bool IsLogEnabled();
+
+  // Recompute whether logging should be enabled (the value of IsLogEnabled is
+  // normally cached).  WARNING: This may not be thread-safe, and is only
+  // really intended for use by unit tests.
+  static void RecomputeLoggingIsEnabled();
 
   // Add/remove observer.
   void AddObserver(const Extension* extension, Observer* observer);
   void RemoveObserver(const Extension* extension,
                       Observer* observer);
 
   // Check for the existence observer list by extension_id.
   bool HasObservers(const Extension* extension) const;
 
   // Log a successful API call made by an extension.
   // This will create an APIAction for storage in the database.
   void LogAPIAction(const Extension* extension,
-                    const std::string& name,    // e.g., chrome.tabs.get
+                    const std::string& name,    // e.g., tabs.get
                     const ListValue* args,      // the argument values e.g. 46
                     const std::string& extra);  // any extra logging info
 
+  // Log an event notification delivered to an extension.
+  // This will create an APIAction for storage in the database.
+  void LogEventAction(const Extension* extension,
+                      const std::string& name,    // e.g., tabs.onUpdate
+                      const ListValue* args,      // arguments to the callback
+                      const std::string& extra);  // any extra logging info
+
   // Log a blocked API call made by an extension.
   // This will create a BlockedAction for storage in the database.
   void LogBlockedAction(const Extension* extension,
-                        const std::string& blocked_call,  // eg chrome.tabs.get
+                        const std::string& blocked_call,  // e.g., tabs.get
                         const ListValue* args,            // argument values
                         const char* reason,               // why it's blocked
                         const std::string& extra);        // extra logging info
 
   // Log an interaction between an extension and a URL.
   // This will create a UrlAction for storage in the database.
   // The technical message might be the list of content scripts that have been
   // injected, or the DOM API call; it's what's shown under "More".
   void LogUrlAction(const Extension* extension,
-                    const UrlAction::UrlActionType verb,  // eg XHR
+                    const UrlAction::UrlActionType verb,  // e.g., XHR
                     const GURL& url,                      // target URL
                     const string16& url_title,            // title of the URL,
                                                           // can be empty string
                     const std::string& technical_message, // "More"
                     const std::string& extra);            // extra logging info
 
   // An error has happened; we want to rollback and close the db.
   // Needs to be public so the error delegate can call it.
   void KillActivityLogDatabase();
 
@@ skipping 81 matching lines @@
 
   virtual bool ServiceRedirectedInIncognito() const OVERRIDE;
 
   DISALLOW_COPY_AND_ASSIGN(ActivityLogFactory);
 };
 
 
 }  // namespace extensions
 
 #endif  // CHROME_BROWSER_EXTENSIONS_ACTIVITY_LOG_H_
-