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 3// found in the LICENSE file. 4 5#ifndef GIN_SHELL_RUNNER_H_ 6#define GIN_SHELL_RUNNER_H_ 7 8#include "gin/runner.h" 9 10namespace gin { 11 12class ContextHolder; 13class ShellRunner; 14class TryCatch; 15 16// Subclass ShellRunnerDelegate to customize the behavior of ShellRunner. 17// Typical embedders will want to subclass one of the specialized 18// ShellRunnerDelegates, such as ModuleRunnerDelegate. 19class GIN_EXPORT ShellRunnerDelegate { 20 public: 21 ShellRunnerDelegate(); 22 virtual ~ShellRunnerDelegate(); 23 24 // Returns the template for the global object. 25 virtual v8::Handle<v8::ObjectTemplate> GetGlobalTemplate( 26 ShellRunner* runner, 27 v8::Isolate* isolate); 28 virtual void DidCreateContext(ShellRunner* runner); 29 virtual void WillRunScript(ShellRunner* runner); 30 virtual void DidRunScript(ShellRunner* runner); 31 virtual void UnhandledException(ShellRunner* runner, TryCatch& try_catch); 32}; 33 34// ShellRunner executes the script/functions directly in a v8::Context. 35// ShellRunner owns a ContextHolder and v8::Context, both of which are destroyed 36// when the ShellRunner is deleted. 37class GIN_EXPORT ShellRunner : public Runner { 38 public: 39 ShellRunner(ShellRunnerDelegate* delegate, v8::Isolate* isolate); 40 virtual ~ShellRunner(); 41 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. 44 45 // Runner overrides: 46 virtual void Run(const std::string& source, 47 const std::string& resource_name) OVERRIDE; 48 virtual v8::Handle<v8::Value> Call(v8::Handle<v8::Function> function, 49 v8::Handle<v8::Value> receiver, 50 int argc, 51 v8::Handle<v8::Value> argv[]) OVERRIDE; 52 virtual ContextHolder* GetContextHolder() OVERRIDE; 53 54 private: 55 friend class Scope; 56 57 void Run(v8::Handle<v8::Script> script); 58 59 ShellRunnerDelegate* delegate_; 60 61 scoped_ptr<ContextHolder> context_holder_; 62 63 DISALLOW_COPY_AND_ASSIGN(ShellRunner); 64}; 65 66} // namespace gin 67 68#endif // GIN_SHELL_RUNNER_H_ 69