| // 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 { |
| |
| class ContextHolder; |
| class ShellRunner; |
| class TryCatch; |
| |
| // Subclass ShellRunnerDelegate to customize the behavior of ShellRunner. |
| // Typical embedders will want to subclass one of the specialized |
| // ShellRunnerDelegates, such as ModuleRunnerDelegate. |
| class GIN_EXPORT ShellRunnerDelegate { |
| public: |
| ShellRunnerDelegate(); |
| virtual ~ShellRunnerDelegate(); |
| |
| // Returns the template for the global object. |
| virtual v8::Local<v8::ObjectTemplate> GetGlobalTemplate( |
| ShellRunner* runner, |
| v8::Isolate* isolate); |
| virtual void DidCreateContext(ShellRunner* runner); |
| virtual void WillRunScript(ShellRunner* runner); |
| virtual void DidRunScript(ShellRunner* runner); |
| virtual void UnhandledException(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_EXPORT ShellRunner : public Runner { |
| public: |
| ShellRunner(ShellRunnerDelegate* delegate, v8::Isolate* isolate); |
| ShellRunner(const ShellRunner&) = delete; |
| ShellRunner& operator=(const ShellRunner&) = 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: |
| friend class Scope; |
| |
| 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_ |