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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
// Copyright (c) 2012 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 CHROME_RENDERER_EXTENSIONS_CHROME_V8_CONTEXT_H_
#define CHROME_RENDERER_EXTENSIONS_CHROME_V8_CONTEXT_H_
#pragma once
#include <string>
#include "base/basictypes.h"
#include "v8/include/v8.h"
namespace WebKit {
class WebFrame;
}
namespace content {
class RenderView;
}
// Chrome's wrapper for a v8 context.
//
// TODO(aa): Consider converting this back to a set of bindings_utils. It would
// require adding WebFrame::GetIsolatedWorldIdByV8Context() to WebCore, but then
// we won't need this object and it's a bit less state to keep track of.
class ChromeV8Context {
public:
enum ContextType {
CONTENT_SCRIPT,
// TODO(kalman): for now, have this as OTHER, since we only currently need
// know whether something is a content script or not. However, when
// necessary this should enumerate the other types, such as FRAME.
OTHER
};
ChromeV8Context(v8::Handle<v8::Context> context,
WebKit::WebFrame* frame,
const std::string& extension_id,
ContextType context_type);
~ChromeV8Context();
v8::Handle<v8::Context> v8_context() const {
return v8_context_;
}
const std::string& extension_id() const {
return extension_id_;
}
WebKit::WebFrame* web_frame() const {
return web_frame_;
}
void clear_web_frame() {
web_frame_ = NULL;
}
ContextType context_type() const {
return context_type_;
}
// Returns a special Chrome-specific hidden object that is associated with a
// context, but not reachable from the JavaScript in that context. This is
// used by our v8::Extension implementations as a way to share code and as a
// bridge between C++ and JavaScript.
static v8::Handle<v8::Value> GetOrCreateChromeHidden(
v8::Handle<v8::Context> context);
// Return the chromeHidden object associated with this context, or an empty
// handle if no chrome hidden has been created (by GetOrCreateChromeHidden)
// yet for this context.
v8::Handle<v8::Value> GetChromeHidden() const;
// Returns the RenderView associated with this context. Can return NULL if the
// context is in the process of being destroyed.
content::RenderView* GetRenderView() const;
// Fires the onload and onunload events on the chromeHidden object.
// TODO(aa): Move this to EventBindings.
void DispatchOnLoadEvent(bool is_extension_process,
bool is_incognito_process,
int manifest_version) const;
void DispatchOnUnloadEvent() const;
// Call the named method of the chromeHidden object in this context.
// The function can be a sub-property like "Port.dispatchOnMessage". Returns
// the result of the function call in |result| if |result| is non-NULL. If the
// named method does not exist, returns false.
bool CallChromeHiddenMethod(
const std::string& function_name,
int argc,
v8::Handle<v8::Value>* argv,
v8::Handle<v8::Value>* result) const;
private:
// The v8 context the bindings are accessible to. We keep a strong reference
// to it for simplicity. In the case of content scripts, this is necessary
// because we want all scripts from the same extension for the same frame to
// run in the same context, so we can't have the contexts being GC'd if
// nothing is happening. In the case of page contexts, this isn't necessary
// since the DOM keeps the context alive, but it makes things simpler to not
// distinguish the two cases.
v8::Persistent<v8::Context> v8_context_;
// The WebFrame associated with this context. This can be NULL because this
// object can outlive is destroyed asynchronously.
WebKit::WebFrame* web_frame_;
// The extension ID this context is associated with.
std::string extension_id_;
// The type of context.
ContextType context_type_;
DISALLOW_COPY_AND_ASSIGN(ChromeV8Context);
};
#endif // CHROME_RENDERER_EXTENSIONS_CHROME_V8_CONTEXT_H_
|
