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.
5 #ifndef EXTENSIONS_COMMON_FEATURES_FEATURE_H_
6 #define EXTENSIONS_COMMON_FEATURES_FEATURE_H_
11 #include "base/values.h"
12 #include "extensions/common/manifest.h"
16 namespace extensions {
20 // Represents a single feature accessible to an extension developer, such as a
21 // top-level manifest key, a permission, or a programmatic API. A feature can
22 // express requirements for where it can be accessed, and supports testing
23 // support for those requirements. If platforms are not specified, then feature
24 // is available on all platforms.
27 // The JavaScript contexts the feature is supported in.
31 // A context in a privileged extension process.
32 BLESSED_EXTENSION_CONTEXT,
34 // A context in an unprivileged extension process.
35 UNBLESSED_EXTENSION_CONTEXT,
37 // A context from a content script.
38 CONTENT_SCRIPT_CONTEXT,
40 // A normal web page. This should have an associated URL matching pattern.
44 // The location required of extensions the feature is supported in.
50 // The platforms the feature is supported in.
59 // Whether a feature is available in a given situation or not, and if not,
61 enum AvailabilityResult {
63 NOT_FOUND_IN_WHITELIST,
69 INVALID_MIN_MANIFEST_VERSION,
70 INVALID_MAX_MANIFEST_VERSION,
75 // Container for AvailabiltyResult that also exposes a user-visible error
76 // message in cases where the feature is not available.
79 AvailabilityResult result() const { return result_; }
80 bool is_available() const { return result_ == IS_AVAILABLE; }
81 const std::string& message() const { return message_; }
84 friend class SimpleFeature;
87 // Instances should be created via Feature::CreateAvailability.
88 Availability(AvailabilityResult result, const std::string& message)
89 : result_(result), message_(message) { }
91 const AvailabilityResult result_;
92 const std::string message_;
98 // Used by ChromeV8Context until the feature system is fully functional.
99 static Availability CreateAvailability(AvailabilityResult result,
100 const std::string& message);
102 const std::string& name() const { return name_; }
103 void set_name(const std::string& name) { name_ = name; }
104 const std::set<std::string>& dependencies() { return dependencies_; }
105 bool no_parent() const { return no_parent_; }
107 // Gets the platform the code is currently running on.
108 static Platform GetCurrentPlatform();
110 // Gets the Feature::Location value for the specified Manifest::Location.
111 static Location ConvertLocation(Manifest::Location extension_location);
113 virtual std::set<Context>* GetContexts() = 0;
115 // Tests whether this is an internal API or not.
116 virtual bool IsInternal() const = 0;
118 // Returns true if the feature is available to be parsed into a new extension
120 Availability IsAvailableToManifest(const std::string& extension_id,
123 int manifest_version) const {
124 return IsAvailableToManifest(extension_id, type, location, manifest_version,
125 GetCurrentPlatform());
127 virtual Availability IsAvailableToManifest(const std::string& extension_id,
130 int manifest_version,
131 Platform platform) const = 0;
133 // Returns true if the feature is available to be used in the specified
134 // extension and context.
135 Availability IsAvailableToContext(const Extension* extension,
137 const GURL& url) const {
138 return IsAvailableToContext(extension, context, url, GetCurrentPlatform());
140 virtual Availability IsAvailableToContext(const Extension* extension,
143 Platform platform) const = 0;
145 virtual std::string GetAvailabilityMessage(AvailabilityResult result,
148 Context context) const = 0;
150 virtual bool IsIdInWhitelist(const std::string& extension_id) const = 0;
154 std::set<std::string> dependencies_;
158 } // namespace extensions
160 #endif // EXTENSIONS_COMMON_FEATURES_FEATURE_H_