chrome/browser/extensions/extension_util.h

   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
  13 namespace base {
  14 class DictionaryValue;
  15 }
  16
  17 namespace content {
  18 class BrowserContext;
  19 }
  20
  21 namespace gfx {
  22 class ImageSkia;
  23 }
  24
  25 namespace extensions {
  26
  27 class Extension;
  28 struct ExtensionInfo;
  29
  30 namespace util {
  31
  32 // Returns true if |extension_id| can run in an incognito window.
  33 bool 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.
  39 void 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).
  45 bool CanCrossIncognito(const extensions::Extension* extension,
  46                        content::BrowserContext* context);
  47
  48 // Returns true if |extension| can be loaded in incognito.
  49 bool CanLoadInIncognito(const extensions::Extension* extension,
  50                         content::BrowserContext* context);
  51
  52 // Returns true if this extension can inject scripts into pages with file URLs.
  53 bool 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.
  59 void 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.
  68 bool 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.
  75 void 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|.
  81 bool ScriptsMayRequireActionForExtension(const Extension* extension);
  82
  83 // Returns true if |extension_id| can be launched (possibly only after being
  84 // enabled).
  85 bool IsAppLaunchable(const std::string& extension_id,
  86                      content::BrowserContext* context);
  87
  88 // Returns true if |extension_id| can be launched without being enabled first.
  89 bool IsAppLaunchableWithoutEnabling(const std::string& extension_id,
  90                                     content::BrowserContext* context);
  91
  92 // Returns true if |extension| should be synced.
  93 bool ShouldSyncExtension(const Extension* extension,
  94                          content::BrowserContext* context);
  95
  96 // Returns true if |app| should be synced.
  97 bool 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.
 101 bool 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().
 106 GURL 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.
 111 scoped_ptr<base::DictionaryValue> GetExtensionInfo(const Extension* extension);
 112
 113 // Returns true if the extension has isolated storage.
 114 bool HasIsolatedStorage(const ExtensionInfo& info);
 115
 116 // Returns true if the site URL corresponds to an extension or app and has
 117 // isolated storage.
 118 bool 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).
 123 const gfx::ImageSkia& GetDefaultExtensionIcon();
 124 const gfx::ImageSkia& GetDefaultAppIcon();
 125
 126 // Returns true if the experimental streamlined hosted apps feature is enabled.
 127 //
 128 // TODO(benwells): http://crbug.com/441127: Rename this to
 129 // IsNewBookmarkAppsEnabled.
 130 //
 131 // TODO(benwells): http://crbug.com/441128: Remove this entirely once the
 132 // feature is stable.
 133 bool IsStreamlinedHostedAppsEnabled();
 134
 135 }  // namespace util
 136 }  // namespace extensions
 137
 138 #endif  // CHROME_BROWSER_EXTENSIONS_EXTENSION_UTIL_H_