
The methodology used to generate this CL is documented in https://crbug.com/1098010#c34. No-Try: true Bug: 1098010 Change-Id: Iafb266228260abedd345bc3e8c1d483c3a4dc4d6 Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/3891087 Commit-Queue: Mark Mentovai <mark@chromium.org> Auto-Submit: Avi Drissman <avi@chromium.org> Owners-Override: Avi Drissman <avi@chromium.org> Reviewed-by: Mark Mentovai <mark@chromium.org> Cr-Commit-Position: refs/heads/main@{#1046550}
68 lines
2.0 KiB
C++
68 lines
2.0 KiB
C++
// 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_
|