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