// Copyright (c) 2019 GitHub, Inc. All rights reserved. // Use of this source code is governed by the MIT license that can be // found in the LICENSE file. #ifndef ELECTRON_SHELL_COMMON_GIN_HELPER_OBJECT_TEMPLATE_BUILDER_H_ #define ELECTRON_SHELL_COMMON_GIN_HELPER_OBJECT_TEMPLATE_BUILDER_H_ #include "base/memory/raw_ptr.h" #include "shell/common/gin_helper/function_template.h" namespace gin_helper { // This class works like gin::ObjectTemplateBuilder, but operates on existing // prototype template instead of creating a new one. // // It also uses gin_helper::CreateFunctionTemplate for function templates to // support gin_helper types. // // TODO(zcbenz): We should patch gin::ObjectTemplateBuilder to provide the same // functionality after removing gin_helper/function_template.h. class ObjectTemplateBuilder { public: ObjectTemplateBuilder(v8::Isolate* isolate, v8::Local templ); ~ObjectTemplateBuilder() = default; // It's against Google C++ style to return a non-const ref, but we take some // poetic license here in order that all calls to Set() can be via the '.' // operator and line up nicely. template ObjectTemplateBuilder& SetValue(const base::StringPiece& name, T val) { return SetImpl(name, ConvertToV8(isolate_, val)); } // In the following methods, T and U can be function pointer, member function // pointer, base::RepeatingCallback, or v8::FunctionTemplate. Most clients // will want to use one of the first two options. Also see // gin::CreateFunctionTemplate() for creating raw function templates. template ObjectTemplateBuilder& SetMethod(const base::StringPiece& name, const T& callback) { return SetImpl(name, CallbackTraits::CreateTemplate(isolate_, callback)); } template ObjectTemplateBuilder& SetProperty(const base::StringPiece& name, const T& getter) { return SetPropertyImpl(name, CallbackTraits::CreateTemplate(isolate_, getter), v8::Local()); } template ObjectTemplateBuilder& SetProperty(const base::StringPiece& name, const T& getter, const U& setter) { return SetPropertyImpl(name, CallbackTraits::CreateTemplate(isolate_, getter), CallbackTraits::CreateTemplate(isolate_, setter)); } v8::Local Build(); private: ObjectTemplateBuilder& SetImpl(const base::StringPiece& name, v8::Local val); ObjectTemplateBuilder& SetPropertyImpl( const base::StringPiece& name, v8::Local getter, v8::Local setter); raw_ptr isolate_; // ObjectTemplateBuilder should only be used on the stack. v8::Local template_; }; } // namespace gin_helper #endif // ELECTRON_SHELL_COMMON_GIN_HELPER_OBJECT_TEMPLATE_BUILDER_H_