1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style license that can be 3 // found in the LICENSE file. 4 5 #ifndef CHROME_BROWSER_EXTENSIONS_EXTENSION_EVENT_ROUTER_H_ 6 #define CHROME_BROWSER_EXTENSIONS_EXTENSION_EVENT_ROUTER_H_ 7 #pragma once 8 9 #include <map> 10 #include <set> 11 #include <string> 12 13 #include "base/memory/ref_counted.h" 14 #include "content/common/notification_observer.h" 15 #include "content/common/notification_registrar.h" 16 17 class GURL; 18 class Extension; 19 class ExtensionDevToolsManager; 20 class Profile; 21 class RenderProcessHost; 22 23 class ExtensionEventRouter : public NotificationObserver { 24 public: 25 // Returns true if the given extension can see events and data from another 26 // sub-profile (incognito to original profile, or vice versa). 27 static bool CanCrossIncognito(Profile* profile, 28 const std::string& extension_id); 29 static bool CanCrossIncognito(Profile* profile, const Extension* extension); 30 31 explicit ExtensionEventRouter(Profile* profile); 32 ~ExtensionEventRouter(); 33 34 // Add or remove the process/extension pair as a listener for |event_name|. 35 // Note that multiple extensions can share a process due to process 36 // collapsing. Also, a single extension can have 2 processes if it is a split 37 // mode extension. 38 void AddEventListener(const std::string& event_name, 39 RenderProcessHost* process, 40 const std::string& extension_id); 41 void RemoveEventListener(const std::string& event_name, 42 RenderProcessHost* process, 43 const std::string& extension_id); 44 45 // Returns true if there is at least one listener for the given event. 46 bool HasEventListener(const std::string& event_name); 47 48 // Returns true if the extension is listening to the given event. 49 bool ExtensionHasEventListener(const std::string& extension_id, 50 const std::string& event_name); 51 52 // Send an event to every registered extension renderer. If 53 // |restrict_to_profile| is non-NULL, then the event will not be sent to other 54 // profiles unless the extension has permission (e.g. incognito tab update -> 55 // normal profile only works if extension is allowed incognito access). If 56 // |event_url| is not empty, the event is only sent to extension with host 57 // permissions for this url. 58 void DispatchEventToRenderers( 59 const std::string& event_name, const std::string& event_args, 60 Profile* restrict_to_profile, const GURL& event_url); 61 62 // Same as above, except only send the event to the given extension. 63 void DispatchEventToExtension( 64 const std::string& extension_id, 65 const std::string& event_name, const std::string& event_args, 66 Profile* restrict_to_profile, const GURL& event_url); 67 68 protected: 69 // Shared by DispatchEvent*. If |extension_id| is empty, the event is 70 // broadcast. 71 virtual void DispatchEventImpl( 72 const std::string& extension_id, 73 const std::string& event_name, const std::string& event_args, 74 Profile* restrict_to_profile, const GURL& event_url); 75 76 private: 77 // An extension listening to an event. 78 struct EventListener; 79 80 virtual void Observe(NotificationType type, 81 const NotificationSource& source, 82 const NotificationDetails& details); 83 84 Profile* profile_; 85 86 NotificationRegistrar registrar_; 87 88 scoped_refptr<ExtensionDevToolsManager> extension_devtools_manager_; 89 90 // A map between an event name and a set of extensions that are listening 91 // to that event. 92 typedef std::map<std::string, std::set<EventListener> > ListenerMap; 93 ListenerMap listeners_; 94 95 DISALLOW_COPY_AND_ASSIGN(ExtensionEventRouter); 96 }; 97 98 #endif // CHROME_BROWSER_EXTENSIONS_EXTENSION_EVENT_ROUTER_H_ 99