1 // Copyright (c) 2012 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 CHROME_RENDERER_EXTENSIONS_CHROME_V8_CONTEXT_SET_H_
6 #define CHROME_RENDERER_EXTENSIONS_CHROME_V8_CONTEXT_SET_H_
11 #include "base/basictypes.h"
12 #include "base/bind.h"
13 #include "v8/include/v8.h"
29 namespace extensions {
30 class ChromeV8Context;
32 // A container of ExtensionBindingsContext. Since calling JavaScript within a
33 // context can cause any number of contexts to be created or destroyed, this
34 // has additional smarts to help with the set changing underneath callers.
35 class ChromeV8ContextSet {
38 ~ChromeV8ContextSet();
42 // Takes ownership of |context|.
43 void Add(ChromeV8Context* context);
45 // If the specified context is contained in this set, remove it, then delete
46 // it asynchronously. After this call returns the context object will still
47 // be valid, but its frame() pointer will be cleared.
48 void Remove(ChromeV8Context* context);
50 // Returns a copy to protect against changes.
51 typedef std::set<ChromeV8Context*> ContextSet;
52 ContextSet GetAll() const;
54 // Gets the ChromeV8Context corresponding to v8::Context::GetCurrent(), or
55 // NULL if no such context exists.
56 ChromeV8Context* GetCurrent() const;
58 // Gets the ChromeV8Context corresponding to v8::Context::GetCalling(), or
59 // NULL if no such context exists.
60 ChromeV8Context* GetCalling() const;
62 // Gets the ChromeV8Context corresponding to the specified
63 // v8::Context or NULL if no such context exists.
64 ChromeV8Context* GetByV8Context(v8::Handle<v8::Context> context) const;
66 // Synchronously runs |callback| with each ChromeV8Context that belongs to
67 // |extension_id| in |render_view|.
69 // |extension_id| may be "" to match all extensions.
70 // |render_view| may be NULL to match all render views.
71 void ForEach(const std::string& extension_id,
72 content::RenderView* render_view,
73 const base::Callback<void(ChromeV8Context*)>& callback) const;
75 // Cleans up contexts belonging to an unloaded extension.
77 // Returns the set of ChromeV8Contexts that were removed as a result. These
78 // are safe to interact with until the end of the current event loop, since
79 // they're deleted asynchronously.
80 ContextSet OnExtensionUnloaded(const std::string& extension_id);
85 DISALLOW_COPY_AND_ASSIGN(ChromeV8ContextSet);
88 } // namespace extensions
90 #endif // CHROME_RENDERER_EXTENSIONS_CHROME_V8_CONTEXT_SET_H_