OLD | NEW |
1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef GIN_SHELL_RUNNER_H_ | 5 #ifndef GIN_SHELL_RUNNER_H_ |
6 #define GIN_SHELL_RUNNER_H_ | 6 #define GIN_SHELL_RUNNER_H_ |
7 | 7 |
8 #include "gin/runner.h" | 8 #include "gin/runner.h" |
9 | 9 |
10 namespace gin { | 10 namespace gin { |
11 | 11 |
12 class ContextHolder; | 12 class ContextHolder; |
13 class ShellRunner; | 13 class ShellRunner; |
14 class TryCatch; | 14 class TryCatch; |
15 | 15 |
16 // Subclass ShellRunnerDelegate to customize the behavior of ShellRunner. | 16 // Subclass ShellRunnerDelegate to customize the behavior of ShellRunner. |
17 // Typical embedders will want to subclass one of the specialized | 17 // Typical embedders will want to subclass one of the specialized |
18 // ShellRunnerDelegates, such as ModuleRunnerDelegate. | 18 // ShellRunnerDelegates, such as ModuleRunnerDelegate. |
19 class GIN_EXPORT ShellRunnerDelegate { | 19 class GIN_EXPORT ShellRunnerDelegate { |
20 public: | 20 public: |
21 ShellRunnerDelegate(); | 21 ShellRunnerDelegate(); |
22 virtual ~ShellRunnerDelegate(); | 22 virtual ~ShellRunnerDelegate(); |
23 | 23 |
24 // Returns the template for the global object. | 24 // Returns the template for the global object. |
25 virtual v8::Handle<v8::ObjectTemplate> GetGlobalTemplate( | 25 virtual v8::Local<v8::ObjectTemplate> GetGlobalTemplate( |
26 ShellRunner* runner, | 26 ShellRunner* runner, |
27 v8::Isolate* isolate); | 27 v8::Isolate* isolate); |
28 virtual void DidCreateContext(ShellRunner* runner); | 28 virtual void DidCreateContext(ShellRunner* runner); |
29 virtual void WillRunScript(ShellRunner* runner); | 29 virtual void WillRunScript(ShellRunner* runner); |
30 virtual void DidRunScript(ShellRunner* runner); | 30 virtual void DidRunScript(ShellRunner* runner); |
31 virtual void UnhandledException(ShellRunner* runner, TryCatch& try_catch); | 31 virtual void UnhandledException(ShellRunner* runner, TryCatch& try_catch); |
32 }; | 32 }; |
33 | 33 |
34 // ShellRunner executes the script/functions directly in a v8::Context. | 34 // ShellRunner executes the script/functions directly in a v8::Context. |
35 // ShellRunner owns a ContextHolder and v8::Context, both of which are destroyed | 35 // ShellRunner owns a ContextHolder and v8::Context, both of which are destroyed |
36 // when the ShellRunner is deleted. | 36 // when the ShellRunner is deleted. |
37 class GIN_EXPORT ShellRunner : public Runner { | 37 class GIN_EXPORT ShellRunner : public Runner { |
38 public: | 38 public: |
39 ShellRunner(ShellRunnerDelegate* delegate, v8::Isolate* isolate); | 39 ShellRunner(ShellRunnerDelegate* delegate, v8::Isolate* isolate); |
40 ~ShellRunner() override; | 40 ~ShellRunner() override; |
41 | 41 |
42 // Before running script in this context, you'll need to enter the runner's | 42 // Before running script in this context, you'll need to enter the runner's |
43 // context by creating an instance of Runner::Scope on the stack. | 43 // context by creating an instance of Runner::Scope on the stack. |
44 | 44 |
45 // Runner overrides: | 45 // Runner overrides: |
46 void Run(const std::string& source, | 46 void Run(const std::string& source, |
47 const std::string& resource_name) override; | 47 const std::string& resource_name) override; |
48 v8::Handle<v8::Value> Call(v8::Handle<v8::Function> function, | 48 v8::Local<v8::Value> Call(v8::Local<v8::Function> function, |
49 v8::Handle<v8::Value> receiver, | 49 v8::Local<v8::Value> receiver, |
50 int argc, | 50 int argc, |
51 v8::Handle<v8::Value> argv[]) override; | 51 v8::Local<v8::Value> argv[]) override; |
52 ContextHolder* GetContextHolder() override; | 52 ContextHolder* GetContextHolder() override; |
53 | 53 |
54 private: | 54 private: |
55 friend class Scope; | 55 friend class Scope; |
56 | 56 |
57 void Run(v8::Handle<v8::Script> script); | 57 void Run(v8::Local<v8::Script> script); |
58 | 58 |
59 ShellRunnerDelegate* delegate_; | 59 ShellRunnerDelegate* delegate_; |
60 | 60 |
61 scoped_ptr<ContextHolder> context_holder_; | 61 scoped_ptr<ContextHolder> context_holder_; |
62 | 62 |
63 DISALLOW_COPY_AND_ASSIGN(ShellRunner); | 63 DISALLOW_COPY_AND_ASSIGN(ShellRunner); |
64 }; | 64 }; |
65 | 65 |
66 } // namespace gin | 66 } // namespace gin |
67 | 67 |
68 #endif // GIN_SHELL_RUNNER_H_ | 68 #endif // GIN_SHELL_RUNNER_H_ |
OLD | NEW |