extensions/browser/notification_types.h

   1 // Copyright 2014 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 EXTENSIONS_BROWSER_NOTIFICATION_TYPES_H_
   6 #define EXTENSIONS_BROWSER_NOTIFICATION_TYPES_H_
   7
   8 #include "content/public/browser/notification_types.h"
   9
  10 namespace extensions {
  11
  12 // Only notifications fired by the extensions module should be here. The
  13 // extensions module should not listen to notifications fired by the
  14 // embedder.
  15 enum NotificationType {
  16   NOTIFICATION_EXTENSIONS_START = content::NOTIFICATION_CONTENT_END,
  17
  18   // Sent when a CrxInstaller finishes. Source is the CrxInstaller that
  19   // finished. The details are the extension which was installed.
  20   NOTIFICATION_CRX_INSTALLER_DONE = NOTIFICATION_EXTENSIONS_START,
  21
  22   // Sent when the known installed extensions have all been loaded.  In
  23   // testing scenarios this can happen multiple times if extensions are
  24   // unloaded and reloaded. The source is a BrowserContext*.
  25   //
  26   // DEPRECATED: Use ExtensionSystem::Get(browser_context)->ready().Post().
  27   NOTIFICATION_EXTENSIONS_READY_DEPRECATED,
  28
  29   // Sent when a new extension is loaded. The details are an Extension, and
  30   // the source is a BrowserContext*.
  31   //
  32   // DEPRECATED: Use ExtensionRegistry::AddObserver instead.
  33   NOTIFICATION_EXTENSION_LOADED_DEPRECATED,
  34
  35   // An error occured while attempting to load an extension. The details are a
  36   // string with details about why the load failed.
  37   NOTIFICATION_EXTENSION_LOAD_ERROR,
  38
  39   // Sent when an extension is enabled. Under most circumstances, listeners will
  40   // want to use ExtensionRegistryObserver::OnExtensionLoaded(). This
  41   // notification is only fired when the "Enable" button is hit in the
  42   // extensions tab. The details are an Extension, and the source is a
  43   // BrowserContext*.
  44   NOTIFICATION_EXTENSION_ENABLED,
  45
  46   // Sent when attempting to load a new extension, but they are disabled. The
  47   // details are an Extension, and the source is a BrowserContext*.
  48   NOTIFICATION_EXTENSION_UPDATE_DISABLED,
  49
  50   // Sent when an extension's permissions change. The details are an
  51   // UpdatedExtensionPermissionsInfo, and the source is a BrowserContext*.
  52   NOTIFICATION_EXTENSION_PERMISSIONS_UPDATED,
  53
  54   // Sent immediately before new extensions are installed or existing
  55   // extensions are updated. The details are an InstalledExtensionInfo, and the
  56   // source is a BrowserContext*.
  57   //
  58   // DEPRECATED: Use ExtensionRegistry::AddObserver instead.
  59   NOTIFICATION_EXTENSION_WILL_BE_INSTALLED_DEPRECATED,
  60
  61   // An error occured during extension install. The details are a string with
  62   // details about why the install failed.
  63   NOTIFICATION_EXTENSION_INSTALL_ERROR,
  64
  65   // Sent when an extension has been uninstalled. The details are an Extension,
  66   // and the source is a BrowserContext*.
  67   //
  68   // DEPRECATED: Use ExtensionRegistry::AddObserver instead.
  69   NOTIFICATION_EXTENSION_UNINSTALLED_DEPRECATED,
  70
  71   // Sent when an extension uninstall is not allowed because the extension is
  72   // not user manageable.  The details are an Extension, and the source is a
  73   // BrowserContext*.
  74   NOTIFICATION_EXTENSION_UNINSTALL_NOT_ALLOWED,
  75
  76   // Sent when an extension is unloaded. This happens when an extension is
  77   // uninstalled or disabled. The details are an UnloadedExtensionInfo, and the
  78   // source is a BrowserContext*.
  79   //
  80   // Note that when this notification is sent, the ExtensionService and the
  81   // ExtensionRegistry have already removed the extension from their internal
  82   // state.
  83   //
  84   // DEPRECATED: Use ExtensionRegistry::AddObserver instead.
  85   NOTIFICATION_EXTENSION_UNLOADED_DEPRECATED,
  86
  87   // Sent when an Extension object is removed from ExtensionService. This
  88   // can happen when an extension is uninstalled, upgraded, or blacklisted,
  89   // including all cases when the Extension is deleted. The details are an
  90   // Extension, and the source is a BrowserContext*.
  91   NOTIFICATION_EXTENSION_REMOVED,
  92
  93   // Sent after a new ExtensionHost* is created. The details are
  94   // an ExtensionHost* and the source is a BrowserContext*.
  95   NOTIFICATION_EXTENSION_HOST_CREATED,
  96
  97   // Sent before an ExtensionHost* is destroyed. The details are
  98   // an ExtensionHost* and the source is a BrowserContext*.
  99   NOTIFICATION_EXTENSION_HOST_DESTROYED,
 100
 101   // Sent by an ExtensionHost* when it has finished its initial page load,
 102   // including any external resources.
 103   // The details are an ExtensionHost* and the source is a BrowserContext*.
 104   NOTIFICATION_EXTENSION_HOST_DID_STOP_LOADING,
 105
 106   // Sent by an ExtensionHost* when its render view requests closing through
 107   // window.close(). The details are an ExtensionHost* and the source is a
 108   // BrowserContext*.
 109   NOTIFICATION_EXTENSION_HOST_VIEW_SHOULD_CLOSE,
 110
 111   // Sent when extension render process ends (whether it crashes or closes). The
 112   // details are an ExtensionHost* and the source is a BrowserContext*. Not sent
 113   // during browser shutdown.
 114   NOTIFICATION_EXTENSION_PROCESS_TERMINATED,
 115
 116   // Sent when a background page is ready so other components can load.
 117   NOTIFICATION_EXTENSION_BACKGROUND_PAGE_READY,
 118
 119   // Sent when the count of page actions has changed. Note that some of them
 120   // may not apply to the current page. The source is a LocationBar*. There
 121   // are no details.
 122   NOTIFICATION_EXTENSION_PAGE_ACTION_COUNT_CHANGED,
 123
 124   // Sent when a browser action's visibility has changed. The source is the
 125   // ExtensionPrefs* that changed, and the details are a std::string with the
 126   // extension's ID.
 127   NOTIFICATION_EXTENSION_BROWSER_ACTION_VISIBILITY_CHANGED,
 128
 129   // Sent when an extension command has been removed. The source is the
 130   // BrowserContext* and the details is a std::pair of two std::string objects
 131   // (an extension ID and the name of the command being removed).
 132   NOTIFICATION_EXTENSION_COMMAND_REMOVED,
 133
 134   // Sent when an extension command has been added. The source is the
 135   // BrowserContext* and the details is a std::pair of two std::string objects
 136   // (an extension ID and the name of the command being added).
 137   NOTIFICATION_EXTENSION_COMMAND_ADDED,
 138
 139   // Sent when an extension command shortcut for a browser action is activated
 140   // on Mac. The source is the BrowserContext* and the details is a std::pair of
 141   // a std::string containing an extension ID and a gfx::NativeWindow for the
 142   // associated window.
 143   NOTIFICATION_EXTENSION_COMMAND_BROWSER_ACTION_MAC,
 144
 145   // Sent when an extension command shortcut for a page action is activated
 146   // on Mac. The source is the BrowserContext* and the details is a std::pair of
 147   // a
 148   // std::string containing an extension ID and a gfx::NativeWindow for the
 149   // associated window.
 150   NOTIFICATION_EXTENSION_COMMAND_PAGE_ACTION_MAC,
 151
 152   // A new extension RenderViewHost has been registered. The details are
 153   // the RenderViewHost*.
 154   NOTIFICATION_EXTENSION_VIEW_REGISTERED,
 155
 156   // An extension RenderViewHost has been unregistered. The details are
 157   // the RenderViewHost*.
 158   NOTIFICATION_EXTENSION_VIEW_UNREGISTERED,
 159
 160   // Sent by an extension to notify the browser about the results of a unit
 161   // test.
 162   NOTIFICATION_EXTENSION_TEST_PASSED,
 163   NOTIFICATION_EXTENSION_TEST_FAILED,
 164
 165   // Sent by extension test javascript code, typically in a browser test. The
 166   // sender is a std::string representing the extension id, and the details
 167   // are a std::string with some message. This is particularly useful when you
 168   // want to have C++ code wait for javascript code to do something.
 169   NOTIFICATION_EXTENSION_TEST_MESSAGE,
 170
 171   // Sent when an bookmarks extensions API function was successfully invoked.
 172   // The source is the id of the extension that invoked the function, and the
 173   // details are a pointer to the const BookmarksFunction in question.
 174   NOTIFICATION_EXTENSION_BOOKMARKS_API_INVOKED,
 175
 176   // Sent when a downloads extensions API event is fired. The source is an
 177   // ExtensionDownloadsEventRouter::NotificationSource, and the details is a
 178   // std::string containing json. Used for testing.
 179   NOTIFICATION_EXTENSION_DOWNLOADS_EVENT,
 180
 181   // Sent when an omnibox extension has sent back omnibox suggestions. The
 182   // source is the BrowserContext*, and the details are an
 183   // extensions::api::omnibox::SendSuggestions::Params object.
 184   NOTIFICATION_EXTENSION_OMNIBOX_SUGGESTIONS_READY,
 185
 186   // Sent when the user accepts the input in an extension omnibox keyword
 187   // session. The source is the BrowserContext*.
 188   NOTIFICATION_EXTENSION_OMNIBOX_INPUT_ENTERED,
 189
 190   // Sent when an omnibox extension has updated the default suggestion. The
 191   // source is the BrowserContext*.
 192   NOTIFICATION_EXTENSION_OMNIBOX_DEFAULT_SUGGESTION_CHANGED,
 193
 194   // Sent when the extension updater starts checking for updates to installed
 195   // extensions. The source is a BrowserContext*, and there are no details.
 196   NOTIFICATION_EXTENSION_UPDATING_STARTED,
 197
 198   // The extension updater found an update and will attempt to download and
 199   // install it. The source is a BrowserContext*, and the details are an
 200   // extensions::UpdateDetails object with the extension id and version of the
 201   // found update.
 202   NOTIFICATION_EXTENSION_UPDATE_FOUND,
 203
 204   // Sent when there are new user scripts available.  The details are a
 205   // pointer to SharedMemory containing the new scripts.
 206   NOTIFICATION_USER_SCRIPTS_UPDATED,
 207   NOTIFICATION_EXTENSIONS_END
 208 };
 209
 210 }  // namespace extensions
 211
 212 #endif  // EXTENSIONS_BROWSER_NOTIFICATION_TYPES_H_