extensions/common/permissions/permission_message.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 EXTENSIONS_COMMON_PERMISSIONS_PERMISSION_MESSAGE_H_
   6 #define EXTENSIONS_COMMON_PERMISSIONS_PERMISSION_MESSAGE_H_
   7
   8 #include <string>
   9 #include <vector>
  10
  11 #include "base/basictypes.h"
  12 #include "base/strings/string16.h"
  13
  14 namespace extensions {
  15
  16 // When prompting the user to install or approve permissions, we display
  17 // messages describing the effects of the permissions rather than listing the
  18 // permissions themselves. Each PermissionMessage represents one of the
  19 // messages shown to the user.
  20 class PermissionMessage {
  21  public:
  22   // Do not reorder this enumeration. If you need to add a new enum, add it just
  23   // prior to kEnumBoundary.
  24   // TODO(sashab): Deprecate these IDs - use whatever APIPermission::ID becomes
  25   // instead.
  26   enum ID {
  27     kUnknown,
  28     kNone,
  29     kBookmarks,
  30     kGeolocation,
  31     kBrowsingHistory,
  32     kTabs,
  33     kManagement,
  34     kDebugger,
  35     kDesktopCapture,
  36     kHid,
  37     kHosts1,
  38     kHosts2,
  39     kHosts3,
  40     kHosts4OrMore,
  41     kHostsAll,
  42     kFullAccess,
  43     kClipboard,
  44     kTtsEngine,
  45     kContentSettings,
  46     kPrivacy,
  47     kSupervisedUser,
  48     kInput,
  49     kAudioCapture,
  50     kVideoCapture,
  51     kDownloads,
  52     kDeleted_FileSystemWrite,
  53     kMediaGalleriesAllGalleriesRead,
  54     kSerial,
  55     kSocketAnyHost,
  56     kSocketDomainHosts,
  57     kSocketSpecificHosts,
  58     kBluetooth,
  59     kUsb,
  60     kSystemIndicator,
  61     kUsbDevice,
  62     kMediaGalleriesAllGalleriesCopyTo,
  63     kSystemInfoDisplay,
  64     kNativeMessaging,
  65     kSyncFileSystem,
  66     kAudio,
  67     kFavicon,
  68     kMusicManagerPrivate,
  69     kWebConnectable,
  70     kActivityLogPrivate,
  71     kBluetoothDevices,
  72     kDownloadsOpen,
  73     kNetworkingPrivate,
  74     kDeclarativeWebRequest,
  75     kFileSystemDirectory,
  76     kFileSystemWriteDirectory,
  77     kSignedInDevices,
  78     kWallpaper,
  79     kNetworkState,
  80     kHomepage,
  81     kSearchProvider,
  82     kStartupPages,
  83     kMediaGalleriesAllGalleriesDelete,
  84     kScreenlockPrivate,
  85     kOverrideBookmarksUI,
  86     kAutomation,
  87     kAccessibilityFeaturesModify,
  88     kAccessibilityFeaturesRead,
  89     kBluetoothPrivate,
  90     kIdentityEmail,
  91     kExperienceSamplingPrivate,
  92     kCopresence,
  93     kTopSites,
  94     kU2fDevices,
  95     kVpnProvider,
  96     kDocumentScan,
  97     kHosts1ReadOnly,
  98     kHosts2ReadOnly,
  99     kHosts3ReadOnly,
 100     kHosts4OrMoreReadOnly,
 101     kHostsAllReadOnly,
 102     kInterceptAllKeys,
 103     // Last entry: Add new entries above and ensure to update the
 104     // "ExtensionPermission2" enum in tools/metrics/histograms/histograms.xml.
 105     kEnumBoundary,
 106   };
 107   static_assert(PermissionMessage::kNone > PermissionMessage::kUnknown,
 108                 "kNone should not greater than kUnknown");
 109
 110   // Creates the corresponding permission message.
 111   PermissionMessage(ID id, const base::string16& message);
 112   PermissionMessage(ID id,
 113                     const base::string16& message,
 114                     const base::string16& details);
 115   ~PermissionMessage();
 116
 117   // Gets the id of the permission message, which can be used in UMA
 118   // histograms.
 119   ID id() const { return id_; }
 120
 121   // Gets a localized message describing this permission. Please note that
 122   // the message will be empty for message types TYPE_NONE and TYPE_UNKNOWN.
 123   const base::string16& message() const { return message_; }
 124
 125   // Gets a localized message describing the details for this permission. Please
 126   // note that the message will be empty for message types TYPE_NONE and
 127   // TYPE_UNKNOWN.
 128   const base::string16& details() const { return details_; }
 129
 130   // Comparator to work with std::set.
 131   bool operator<(const PermissionMessage& that) const {
 132     return id_ < that.id_;
 133   }
 134   // Comparator to work with base::STLSetDifference.
 135   bool operator>(const PermissionMessage& that) const {
 136     return id_ > that.id_;
 137   }
 138
 139  private:
 140   ID id_;
 141   base::string16 message_;
 142   base::string16 details_;
 143 };
 144
 145 typedef std::vector<PermissionMessage> PermissionMessages;
 146
 147 }  // namespace extensions
 148
 149 #endif  // EXTENSIONS_COMMON_PERMISSIONS_PERMISSION_MESSAGE_H_