// Copyright (c) 2019 GitHub, Inc. // Use of this source code is governed by the MIT license that can be // found in the LICENSE file. #ifndef SHELL_COMMON_GIN_HELPER_DICTIONARY_H_ #define SHELL_COMMON_GIN_HELPER_DICTIONARY_H_ #include #include "gin/dictionary.h" #include "shell/common/gin_converters/std_converter.h" #include "shell/common/gin_helper/function_template.h" namespace gin_helper { // Adds a few more extends methods to gin::Dictionary. // // Note that as the destructor of gin::Dictionary is not virtual, and we want to // convert between 2 types, we must not add any member. class Dictionary : public gin::Dictionary { public: Dictionary() : gin::Dictionary(nullptr) {} Dictionary(v8::Isolate* isolate, v8::Local object) : gin::Dictionary(isolate, object) {} // Allow implicitly converting from gin::Dictionary, as it is absolutely // safe in this case. Dictionary(const gin::Dictionary& dict) // NOLINT(runtime/explicit) : gin::Dictionary(dict) {} // Differences from the Get method in gin::Dictionary: // 1. This is a const method; // 2. It checks whether the key exists before reading; // 3. It accepts arbitrary type of key. template bool Get(const K& key, V* out) const { // Check for existence before getting, otherwise this method will always // returns true when T == v8::Local. v8::Local context = isolate()->GetCurrentContext(); v8::Local v8_key = gin::ConvertToV8(isolate(), key); v8::Local value; v8::Maybe result = GetHandle()->Has(context, v8_key); if (result.IsJust() && result.FromJust() && GetHandle()->Get(context, v8_key).ToLocal(&value)) return gin::ConvertFromV8(isolate(), value, out); return false; } // Differences from the Set method in gin::Dictionary: // 1. It accepts arbitrary type of key. // 2. It forces using gin::ConvertFromV8 (would no longer be needed after // removing native_mate). template bool Set(const K& key, const V& val) { v8::Local v8_value; if (!gin::TryConvertToV8(isolate(), val, &v8_value)) return false; v8::Maybe result = GetHandle()->Set(isolate()->GetCurrentContext(), gin::ConvertToV8(isolate(), key), v8_value); return !result.IsNothing() && result.FromJust(); } template bool GetHidden(base::StringPiece key, T* out) const { v8::Local context = isolate()->GetCurrentContext(); v8::Local privateKey = v8::Private::ForApi(isolate(), gin::StringToV8(isolate(), key)); v8::Local value; v8::Maybe result = GetHandle()->HasPrivate(context, privateKey); if (result.IsJust() && result.FromJust() && GetHandle()->GetPrivate(context, privateKey).ToLocal(&value)) return gin::ConvertFromV8(isolate(), value, out); return false; } template bool SetHidden(base::StringPiece key, T val) { v8::Local v8_value; if (!gin::TryConvertToV8(isolate(), val, &v8_value)) return false; v8::Local context = isolate()->GetCurrentContext(); v8::Local privateKey = v8::Private::ForApi(isolate(), gin::StringToV8(isolate(), key)); v8::Maybe result = GetHandle()->SetPrivate(context, privateKey, v8_value); return !result.IsNothing() && result.FromJust(); } template bool SetMethod(base::StringPiece key, const T& callback) { auto context = isolate()->GetCurrentContext(); auto templ = CallbackTraits::CreateTemplate(isolate(), callback); return GetHandle() ->Set(context, gin::StringToV8(isolate(), key), templ->GetFunction(context).ToLocalChecked()) .ToChecked(); } template bool SetReadOnly(base::StringPiece key, const T& val) { v8::Local v8_value; if (!gin::TryConvertToV8(isolate(), val, &v8_value)) return false; v8::Maybe result = GetHandle()->DefineOwnProperty( isolate()->GetCurrentContext(), gin::StringToV8(isolate(), key), v8_value, v8::ReadOnly); return !result.IsNothing() && result.FromJust(); } bool Delete(base::StringPiece key) { v8::Maybe result = GetHandle()->Delete( isolate()->GetCurrentContext(), gin::StringToV8(isolate(), key)); return !result.IsNothing() && result.FromJust(); } bool IsEmpty() const { return isolate() == nullptr || GetHandle().IsEmpty(); } v8::Local GetHandle() const { return gin::ConvertToV8(isolate(), *static_cast(this)) .As(); } private: // DO NOT ADD ANY DATA MEMBER. }; } // namespace gin_helper namespace gin { template <> struct Converter { static v8::Local ToV8(v8::Isolate* isolate, gin_helper::Dictionary val) { return val.GetHandle(); } static bool FromV8(v8::Isolate* isolate, v8::Local val, gin_helper::Dictionary* out) { gin::Dictionary gdict(isolate); if (!ConvertFromV8(isolate, val, &gdict)) return false; *out = gin_helper::Dictionary(gdict); return true; } }; } // namespace gin #endif // SHELL_COMMON_GIN_HELPER_DICTIONARY_H_