| // Copyright 2014 The Chromium Authors |
| // Use of this source code is governed by a BSD-style license that can be |
| // found in the LICENSE file. |
| |
| #ifndef GIN_SHELL_RUNNER_H_ |
| #define GIN_SHELL_RUNNER_H_ |
| |
| #include<memory> |
| |
| #include"base/memory/raw_ptr.h" |
| #include"gin/runner.h" |
| |
| namespace gin{ |
| |
| classContextHolder; |
| classShellRunner; |
| classTryCatch; |
| |
| // Subclass ShellRunnerDelegate to customize the behavior of ShellRunner. |
| // Typical embedders will want to subclass one of the specialized |
| // ShellRunnerDelegates, such as ModuleRunnerDelegate. |
| class GIN_EXPORTShellRunnerDelegate{ |
| public: |
| ShellRunnerDelegate(); |
| virtual~ShellRunnerDelegate(); |
| |
| // Returns the template for the global object. |
| virtual v8::Local<v8::ObjectTemplate>GetGlobalTemplate( |
| ShellRunner* runner, |
| v8::Isolate* isolate); |
| virtualvoidDidCreateContext(ShellRunner* runner); |
| virtualvoidWillRunScript(ShellRunner* runner); |
| virtualvoidDidRunScript(ShellRunner* runner); |
| virtualvoidUnhandledException(ShellRunner* runner,TryCatch& try_catch); |
| }; |
| |
| // ShellRunner executes the script/functions directly in a v8::Context. |
| // ShellRunner owns a ContextHolder and v8::Context, both of which are destroyed |
| // when the ShellRunner is deleted. |
| class GIN_EXPORTShellRunner:publicRunner{ |
| public: |
| ShellRunner(ShellRunnerDelegate*delegate, v8::Isolate* isolate); |
| ShellRunner(constShellRunner&)=delete; |
| ShellRunner&operator=(constShellRunner&)=delete; |
| ~ShellRunner()override; |
| |
| // Before running script in this context, you'll need to enter the runner's |
| // context by creating an instance of Runner::Scope on the stack. |
| |
| // Runner overrides: |
| v8::MaybeLocal<v8::Value>Run(const std::string& source, |
| const std::string& resource_name)override; |
| ContextHolder*GetContextHolder()override; |
| |
| private: |
| friendclassScope; |
| |
| v8::MaybeLocal<v8::Value>Run(v8::Local<v8::Script> script); |
| |
| raw_ptr<ShellRunnerDelegate> delegate_; |
| |
| std::unique_ptr<ContextHolder> context_holder_; |
| }; |
| |
| }// namespace gin |
| |
| #endif// GIN_SHELL_RUNNER_H_ |
