1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef EXTENSIONS_BROWSER_RUNTIME_DATA_H_
#define EXTENSIONS_BROWSER_RUNTIME_DATA_H_
#include <map>
#include <string>
#include "base/compiler_specific.h"
#include "extensions/browser/extension_registry_observer.h"
namespace extensions {
class ExtensionRegistry;
// Contains per-extension data that can change during the life of the process,
// but does not persist across restarts. Shared between incognito and regular
// browser contexts. Lives on the UI thread. Must be destroyed before
// ExtensionRegistry.
// If we start putting to much into this, we should expose the generic
// "[G|S]etRuntimeProperty(const std::string& extension_id, RuntimeFlag flag)"
// instead of all these.
class RuntimeData : public ExtensionRegistryObserver {
public:
// Observes |registry| to clean itself up when extensions change state.
// |registry| must not be NULL.
explicit RuntimeData(ExtensionRegistry* registry);
~RuntimeData() override;
// Whether the persistent background page, if any, is ready. We don't load
// other components until then. If there is no background page, or if it is
// non-persistent (lazy), we consider it to be ready.
bool IsBackgroundPageReady(const Extension* extension) const;
void SetBackgroundPageReady(const std::string& extension_id, bool value);
// Getter and setter for the flag that specifies whether the extension is
// being upgraded.
// For these purposes, a reload counts as an upgrade.
bool IsBeingUpgraded(const std::string& extension_id) const;
void SetBeingUpgraded(const std::string& extension_id, bool value);
// Getter and setter for the flag that specifies if the extension has used
// the webrequest API.
bool HasUsedWebRequest(const std::string& extension_id) const;
void SetHasUsedWebRequest(const std::string& extension_id, bool value);
// Returns true if the extension is being tracked. Used only for testing.
bool HasExtensionForTesting(const std::string& extension_id) const;
// Erase runtime data for all extensions. Used only for testing. Cannot be
// named ClearAllForTesting due to false-positive presubmit errors.
void ClearAll();
// ExtensionRegistryObserver overrides. Public for testing.
void OnExtensionUnloaded(content::BrowserContext* browser_context,
const Extension* extension,
UnloadedExtensionInfo::Reason reason) override;
private:
// Bitmasks for runtime states.
enum RuntimeFlag {
// Set if the background page is ready.
BACKGROUND_PAGE_READY = 1 << 0,
// Set while the extension is being upgraded.
BEING_UPGRADED = 1 << 1,
// Set if the extension has used the webRequest API.
HAS_USED_WEBREQUEST = 1 << 2,
};
// The mask of any data that should persist across the extension being
// unloaded.
static const int kPersistAcrossUnloadMask = BEING_UPGRADED;
// Returns the setting for the flag or false if the extension isn't found.
bool HasFlag(const std::string& extension_id, RuntimeFlag flag) const;
// Sets |flag| for |extension| to |value|. Adds |extension| to the list of
// extensions if it isn't present.
void SetFlag(const std::string& extension_id, RuntimeFlag flag, bool value);
// Map from extension ID to the RuntimeFlags bits.
typedef std::map<std::string, int> ExtensionFlagsMap;
ExtensionFlagsMap extension_flags_;
ExtensionRegistry* registry_; // Not owned.
};
} // namespace extensions
#endif // EXTENSIONS_BROWSER_RUNTIME_DATA_H_
|
