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_MANIFEST_HANDLERS_BACKGROUND_INFO_H_ 6 #define EXTENSIONS_COMMON_MANIFEST_HANDLERS_BACKGROUND_INFO_H_ 7 8 #include <string> 9 #include <vector> 10 11 #include "base/values.h" 12 #include "extensions/common/extension.h" 13 #include "extensions/common/manifest_handler.h" 14 #include "url/gurl.h" 15 16 namespace extensions { 17 18 class BackgroundInfo : public Extension::ManifestData { 19 public: 20 BackgroundInfo(); 21 virtual ~BackgroundInfo(); 22 23 static GURL GetBackgroundURL(const Extension* extension); 24 static const std::vector<std::string>& GetBackgroundScripts( 25 const Extension* extension); 26 static bool HasBackgroundPage(const Extension* extension); 27 static bool HasPersistentBackgroundPage(const Extension* extension); 28 static bool HasLazyBackgroundPage(const Extension* extension); 29 static bool HasGeneratedBackgroundPage(const Extension* extension); 30 static bool AllowJSAccess(const Extension* extension); 31 has_background_page()32 bool has_background_page() const { 33 return background_url_.is_valid() || !background_scripts_.empty(); 34 } 35 has_persistent_background_page()36 bool has_persistent_background_page() const { 37 return has_background_page() && is_persistent_; 38 } 39 has_lazy_background_page()40 bool has_lazy_background_page() const { 41 return has_background_page() && !is_persistent_; 42 } 43 44 bool Parse(const Extension* extension, string16* error); 45 46 private: 47 bool LoadBackgroundScripts(const Extension* extension, 48 const std::string& key, 49 string16* error); 50 bool LoadBackgroundPage(const Extension* extension, 51 const std::string& key, 52 string16* error); 53 bool LoadBackgroundPage(const Extension* extension, string16* error); 54 bool LoadBackgroundPersistent(const Extension* extension, string16* error); 55 bool LoadAllowJSAccess(const Extension* extension, string16* error); 56 57 // Optional URL to a master page of which a single instance should be always 58 // loaded in the background. 59 GURL background_url_; 60 61 // Optional list of scripts to use to generate a background page. If this is 62 // present, background_url_ will be empty and generated by GetBackgroundURL(). 63 std::vector<std::string> background_scripts_; 64 65 // True if the background page should stay loaded forever; false if it should 66 // load on-demand (when it needs to handle an event). Defaults to true. 67 bool is_persistent_; 68 69 // True if the background page can be scripted by pages of the app or 70 // extension, in which case all such pages must run in the same process. 71 // False if such pages are not permitted to script the background page, 72 // allowing them to run in different processes. 73 // Defaults to true. 74 bool allow_js_access_; 75 76 DISALLOW_COPY_AND_ASSIGN(BackgroundInfo); 77 }; 78 79 // Parses all background/event page-related keys in the manifest. 80 class BackgroundManifestHandler : public ManifestHandler { 81 public: 82 BackgroundManifestHandler(); 83 virtual ~BackgroundManifestHandler(); 84 85 virtual bool Parse(Extension* extension, string16* error) OVERRIDE; 86 virtual bool Validate(const Extension* extension, 87 std::string* error, 88 std::vector<InstallWarning>* warnings) const OVERRIDE; 89 virtual bool AlwaysParseForType(Manifest::Type type) const OVERRIDE; 90 91 private: 92 virtual const std::vector<std::string> Keys() const OVERRIDE; 93 94 DISALLOW_COPY_AND_ASSIGN(BackgroundManifestHandler); 95 }; 96 97 } // namespace extensions 98 99 #endif // EXTENSIONS_COMMON_MANIFEST_HANDLERS_BACKGROUND_INFO_H_ 100