1// Copyright 2013 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_UTIL_H_
6#define CHROME_BROWSER_EXTENSIONS_EXTENSION_UTIL_H_
7
8#include <string>
9
10#include "base/memory/scoped_ptr.h"
11#include "url/gurl.h"
12
13namespace base {
14class DictionaryValue;
15}
16
17namespace content {
18class BrowserContext;
19}
20
21namespace gfx {
22class ImageSkia;
23}
24
25namespace extensions {
26
27class Extension;
28struct ExtensionInfo;
29
30namespace util {
31
32// Returns true if |extension_id| can run in an incognito window.
33bool IsIncognitoEnabled(const std::string& extension_id,
34                        content::BrowserContext* context);
35
36// Sets whether |extension_id| can run in an incognito window. Reloads the
37// extension if it's enabled since this permission is applied at loading time
38// only. Note that an ExtensionService must exist.
39void SetIsIncognitoEnabled(const std::string& extension_id,
40                           content::BrowserContext* context,
41                           bool enabled);
42
43// Returns true if |extension| can see events and data from another sub-profile
44// (incognito to original profile, or vice versa).
45bool CanCrossIncognito(const extensions::Extension* extension,
46                       content::BrowserContext* context);
47
48// Returns true if |extension| can be loaded in incognito.
49bool CanLoadInIncognito(const extensions::Extension* extension,
50                        content::BrowserContext* context);
51
52// Returns true if this extension can inject scripts into pages with file URLs.
53bool AllowFileAccess(const std::string& extension_id,
54                     content::BrowserContext* context);
55
56// Sets whether |extension_id| can inject scripts into pages with file URLs.
57// Reloads the extension if it's enabled since this permission is applied at
58// loading time only. Note than an ExtensionService must exist.
59void SetAllowFileAccess(const std::string& extension_id,
60                        content::BrowserContext* context,
61                        bool allow);
62
63// Returns true if the extension with |extension_id| is allowed to execute
64// scripts on all urls (exempting chrome:// urls, etc) without explicit
65// user consent.
66// This should only be used with FeatureSwitch::scripts_require_action()
67// enabled.
68bool AllowedScriptingOnAllUrls(const std::string& extension_id,
69                               content::BrowserContext* context);
70
71// Sets whether the extension with |extension_id| is allowed to execute scripts
72// on all urls (exempting chrome:// urls, etc) without explicit user consent.
73// This should only be used with FeatureSwitch::scripts_require_action()
74// enabled.
75void SetAllowedScriptingOnAllUrls(const std::string& extension_id,
76                                  content::BrowserContext* context,
77                                  bool allowed);
78
79// Returns true if the --scripts-require-action flag would possibly affect
80// the given |extension|.
81bool ScriptsMayRequireActionForExtension(const Extension* extension);
82
83// Returns true if |extension_id| can be launched (possibly only after being
84// enabled).
85bool IsAppLaunchable(const std::string& extension_id,
86                     content::BrowserContext* context);
87
88// Returns true if |extension_id| can be launched without being enabled first.
89bool IsAppLaunchableWithoutEnabling(const std::string& extension_id,
90                                    content::BrowserContext* context);
91
92// Returns true if |extension| should be synced.
93bool ShouldSyncExtension(const Extension* extension,
94                         content::BrowserContext* context);
95
96// Returns true if |app| should be synced.
97bool ShouldSyncApp(const Extension* app, content::BrowserContext* context);
98
99// Returns true if |extension_id| is idle and it is safe to perform actions such
100// as updating.
101bool IsExtensionIdle(const std::string& extension_id,
102                     content::BrowserContext* context);
103
104// Returns the site of the |extension_id|, given the associated |context|.
105// Suitable for use with BrowserContext::GetStoragePartitionForSite().
106GURL GetSiteForExtensionId(const std::string& extension_id,
107                           content::BrowserContext* context);
108
109// Sets the name, id, and icon resource path of the given extension into the
110// returned dictionary.
111scoped_ptr<base::DictionaryValue> GetExtensionInfo(const Extension* extension);
112
113// Returns true if the extension has isolated storage.
114bool HasIsolatedStorage(const ExtensionInfo& info);
115
116// Returns true if the site URL corresponds to an extension or app and has
117// isolated storage.
118bool SiteHasIsolatedStorage(const GURL& extension_site_url,
119                            content::BrowserContext* context);
120
121// Returns the default extension/app icon (for extensions or apps that don't
122// have one).
123const gfx::ImageSkia& GetDefaultExtensionIcon();
124const gfx::ImageSkia& GetDefaultAppIcon();
125
126// Returns true if the experimental streamlined hosted apps feature is enabled.
127bool IsStreamlinedHostedAppsEnabled();
128
129}  // namespace util
130}  // namespace extensions
131
132#endif  // CHROME_BROWSER_EXTENSIONS_EXTENSION_UTIL_H_
133