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
|
// 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_SCRIPT_EXECUTOR_H_
#define EXTENSIONS_BROWSER_SCRIPT_EXECUTOR_H_
#include "base/callback_forward.h"
#include "base/observer_list.h"
#include "extensions/common/user_script.h"
class GURL;
struct ExtensionMsg_ExecuteCode_Params;
namespace base {
class ListValue;
} // namespace base
namespace content {
class WebContents;
}
namespace extensions {
class ScriptExecutionObserver;
// Interface for executing extension content scripts (e.g. executeScript) as
// described by the ExtensionMsg_ExecuteCode_Params IPC, and notifying the
// caller when responded with ExtensionHostMsg_ExecuteCodeFinished.
class ScriptExecutor {
public:
ScriptExecutor(
content::WebContents* web_contents,
// |script_observers| is assumed to be owned by |this|'s owner, and in
// such a way that |this| is destroyed first.
base::ObserverList<ScriptExecutionObserver>* script_observers);
~ScriptExecutor();
// The type of script being injected.
enum ScriptType {
JAVASCRIPT,
CSS,
};
// The scope of the script injection across the frames.
enum FrameScope {
SINGLE_FRAME,
INCLUDE_SUB_FRAMES,
};
// Whether to insert the script in about: frames when its origin matches
// the extension's host permissions.
enum MatchAboutBlank {
DONT_MATCH_ABOUT_BLANK,
MATCH_ABOUT_BLANK,
};
// The type of world to inject into (main world, or its own isolated world).
enum WorldType {
MAIN_WORLD,
ISOLATED_WORLD,
};
// The type of process the target is.
enum ProcessType {
DEFAULT_PROCESS,
WEB_VIEW_PROCESS,
};
// The type of result the caller is interested in.
enum ResultType {
NO_RESULT,
JSON_SERIALIZED_RESULT,
};
// Callback from ExecuteScript. The arguments are (error, on_url, result).
// Success is implied by an empty error.
typedef base::Callback<
void(const std::string&, const GURL&, const base::ListValue&)>
ExecuteScriptCallback;
// Executes a script. The arguments match ExtensionMsg_ExecuteCode_Params in
// extension_messages.h (request_id is populated automatically).
//
// The script will be executed in the frame identified by |frame_id| (which is
// an extension API frame ID). If |frame_scope| is INCLUDE_SUB_FRAMES, then
// the script will also be executed in all descendants of the frame.
//
// |callback| will always be called even if the IPC'd renderer is destroyed
// before a response is received (in this case the callback will be with a
// failure and appropriate error message).
void ExecuteScript(const HostID& host_id,
ScriptType script_type,
const std::string& code,
FrameScope frame_scope,
int frame_id,
MatchAboutBlank match_about_blank,
UserScript::RunLocation run_at,
WorldType world_type,
ProcessType process_type,
const GURL& webview_src,
const GURL& file_url,
bool user_gesture,
ResultType result_type,
const ExecuteScriptCallback& callback);
private:
// The next value to use for request_id in ExtensionMsg_ExecuteCode_Params.
int next_request_id_;
content::WebContents* web_contents_;
base::ObserverList<ScriptExecutionObserver>* script_observers_;
};
} // namespace extensions
#endif // EXTENSIONS_BROWSER_SCRIPT_EXECUTOR_H_
|
