6607 lines
214 KiB
6607 lines
214 KiB
#ifndef SRC_NAPI_INL_H_ |
|
#define SRC_NAPI_INL_H_ |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Node-API C++ Wrapper Classes |
|
// |
|
// Inline header-only implementations for "Node-API" ABI-stable C APIs for |
|
// Node.js. |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
// Note: Do not include this file directly! Include "napi.h" instead. |
|
|
|
#include <algorithm> |
|
#include <cstring> |
|
#if NAPI_HAS_THREADS |
|
#include <mutex> |
|
#endif // NAPI_HAS_THREADS |
|
#include <type_traits> |
|
#include <utility> |
|
|
|
namespace Napi { |
|
|
|
#ifdef NAPI_CPP_CUSTOM_NAMESPACE |
|
namespace NAPI_CPP_CUSTOM_NAMESPACE { |
|
#endif |
|
|
|
// Helpers to handle functions exposed from C++ and internal constants. |
|
namespace details { |
|
|
|
// New napi_status constants not yet available in all supported versions of |
|
// Node.js releases. Only necessary when they are used in napi.h and napi-inl.h. |
|
constexpr int napi_no_external_buffers_allowed = 22; |
|
|
|
template <typename FreeType> |
|
inline void default_finalizer(napi_env /*env*/, void* data, void* /*hint*/) { |
|
delete static_cast<FreeType*>(data); |
|
} |
|
|
|
// Attach a data item to an object and delete it when the object gets |
|
// garbage-collected. |
|
// TODO: Replace this code with `napi_add_finalizer()` whenever it becomes |
|
// available on all supported versions of Node.js. |
|
template <typename FreeType, |
|
napi_finalize finalizer = default_finalizer<FreeType>> |
|
inline napi_status AttachData(napi_env env, |
|
napi_value obj, |
|
FreeType* data, |
|
void* hint = nullptr) { |
|
napi_status status; |
|
#if (NAPI_VERSION < 5) |
|
napi_value symbol, external; |
|
status = napi_create_symbol(env, nullptr, &symbol); |
|
if (status == napi_ok) { |
|
status = napi_create_external(env, data, finalizer, hint, &external); |
|
if (status == napi_ok) { |
|
napi_property_descriptor desc = {nullptr, |
|
symbol, |
|
nullptr, |
|
nullptr, |
|
nullptr, |
|
external, |
|
napi_default, |
|
nullptr}; |
|
status = napi_define_properties(env, obj, 1, &desc); |
|
} |
|
} |
|
#else // NAPI_VERSION >= 5 |
|
status = napi_add_finalizer(env, obj, data, finalizer, hint, nullptr); |
|
#endif |
|
return status; |
|
} |
|
|
|
// For use in JS to C++ callback wrappers to catch any Napi::Error exceptions |
|
// and rethrow them as JavaScript exceptions before returning from the callback. |
|
template <typename Callable> |
|
inline napi_value WrapCallback(Callable callback) { |
|
#ifdef NAPI_CPP_EXCEPTIONS |
|
try { |
|
return callback(); |
|
} catch (const Error& e) { |
|
e.ThrowAsJavaScriptException(); |
|
return nullptr; |
|
} |
|
#else // NAPI_CPP_EXCEPTIONS |
|
// When C++ exceptions are disabled, errors are immediately thrown as JS |
|
// exceptions, so there is no need to catch and rethrow them here. |
|
return callback(); |
|
#endif // NAPI_CPP_EXCEPTIONS |
|
} |
|
|
|
// For use in JS to C++ void callback wrappers to catch any Napi::Error |
|
// exceptions and rethrow them as JavaScript exceptions before returning from |
|
// the callback. |
|
template <typename Callable> |
|
inline void WrapVoidCallback(Callable callback) { |
|
#ifdef NAPI_CPP_EXCEPTIONS |
|
try { |
|
callback(); |
|
} catch (const Error& e) { |
|
e.ThrowAsJavaScriptException(); |
|
} |
|
#else // NAPI_CPP_EXCEPTIONS |
|
// When C++ exceptions are disabled, errors are immediately thrown as JS |
|
// exceptions, so there is no need to catch and rethrow them here. |
|
callback(); |
|
#endif // NAPI_CPP_EXCEPTIONS |
|
} |
|
|
|
template <typename Callable, typename Return> |
|
struct CallbackData { |
|
static inline napi_value Wrapper(napi_env env, napi_callback_info info) { |
|
return details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
CallbackData* callbackData = |
|
static_cast<CallbackData*>(callbackInfo.Data()); |
|
callbackInfo.SetData(callbackData->data); |
|
return callbackData->callback(callbackInfo); |
|
}); |
|
} |
|
|
|
Callable callback; |
|
void* data; |
|
}; |
|
|
|
template <typename Callable> |
|
struct CallbackData<Callable, void> { |
|
static inline napi_value Wrapper(napi_env env, napi_callback_info info) { |
|
return details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
CallbackData* callbackData = |
|
static_cast<CallbackData*>(callbackInfo.Data()); |
|
callbackInfo.SetData(callbackData->data); |
|
callbackData->callback(callbackInfo); |
|
return nullptr; |
|
}); |
|
} |
|
|
|
Callable callback; |
|
void* data; |
|
}; |
|
|
|
template <void (*Callback)(const CallbackInfo& info)> |
|
napi_value TemplatedVoidCallback(napi_env env, |
|
napi_callback_info info) NAPI_NOEXCEPT { |
|
return details::WrapCallback([&] { |
|
CallbackInfo cbInfo(env, info); |
|
Callback(cbInfo); |
|
return nullptr; |
|
}); |
|
} |
|
|
|
template <Napi::Value (*Callback)(const CallbackInfo& info)> |
|
napi_value TemplatedCallback(napi_env env, |
|
napi_callback_info info) NAPI_NOEXCEPT { |
|
return details::WrapCallback([&] { |
|
CallbackInfo cbInfo(env, info); |
|
return Callback(cbInfo); |
|
}); |
|
} |
|
|
|
template <typename T, |
|
Napi::Value (T::*UnwrapCallback)(const CallbackInfo& info)> |
|
napi_value TemplatedInstanceCallback(napi_env env, |
|
napi_callback_info info) NAPI_NOEXCEPT { |
|
return details::WrapCallback([&] { |
|
CallbackInfo cbInfo(env, info); |
|
T* instance = T::Unwrap(cbInfo.This().As<Object>()); |
|
return instance ? (instance->*UnwrapCallback)(cbInfo) : Napi::Value(); |
|
}); |
|
} |
|
|
|
template <typename T, void (T::*UnwrapCallback)(const CallbackInfo& info)> |
|
napi_value TemplatedInstanceVoidCallback(napi_env env, napi_callback_info info) |
|
NAPI_NOEXCEPT { |
|
return details::WrapCallback([&] { |
|
CallbackInfo cbInfo(env, info); |
|
T* instance = T::Unwrap(cbInfo.This().As<Object>()); |
|
if (instance) (instance->*UnwrapCallback)(cbInfo); |
|
return nullptr; |
|
}); |
|
} |
|
|
|
template <typename T, typename Finalizer, typename Hint = void> |
|
struct FinalizeData { |
|
static inline void Wrapper(napi_env env, |
|
void* data, |
|
void* finalizeHint) NAPI_NOEXCEPT { |
|
WrapVoidCallback([&] { |
|
FinalizeData* finalizeData = static_cast<FinalizeData*>(finalizeHint); |
|
finalizeData->callback(Env(env), static_cast<T*>(data)); |
|
delete finalizeData; |
|
}); |
|
} |
|
|
|
static inline void WrapperWithHint(napi_env env, |
|
void* data, |
|
void* finalizeHint) NAPI_NOEXCEPT { |
|
WrapVoidCallback([&] { |
|
FinalizeData* finalizeData = static_cast<FinalizeData*>(finalizeHint); |
|
finalizeData->callback( |
|
Env(env), static_cast<T*>(data), finalizeData->hint); |
|
delete finalizeData; |
|
}); |
|
} |
|
|
|
Finalizer callback; |
|
Hint* hint; |
|
}; |
|
|
|
#if (NAPI_VERSION > 3 && NAPI_HAS_THREADS) |
|
template <typename ContextType = void, |
|
typename Finalizer = std::function<void(Env, void*, ContextType*)>, |
|
typename FinalizerDataType = void> |
|
struct ThreadSafeFinalize { |
|
static inline void Wrapper(napi_env env, |
|
void* rawFinalizeData, |
|
void* /* rawContext */) { |
|
if (rawFinalizeData == nullptr) return; |
|
|
|
ThreadSafeFinalize* finalizeData = |
|
static_cast<ThreadSafeFinalize*>(rawFinalizeData); |
|
finalizeData->callback(Env(env)); |
|
delete finalizeData; |
|
} |
|
|
|
static inline void FinalizeWrapperWithData(napi_env env, |
|
void* rawFinalizeData, |
|
void* /* rawContext */) { |
|
if (rawFinalizeData == nullptr) return; |
|
|
|
ThreadSafeFinalize* finalizeData = |
|
static_cast<ThreadSafeFinalize*>(rawFinalizeData); |
|
finalizeData->callback(Env(env), finalizeData->data); |
|
delete finalizeData; |
|
} |
|
|
|
static inline void FinalizeWrapperWithContext(napi_env env, |
|
void* rawFinalizeData, |
|
void* rawContext) { |
|
if (rawFinalizeData == nullptr) return; |
|
|
|
ThreadSafeFinalize* finalizeData = |
|
static_cast<ThreadSafeFinalize*>(rawFinalizeData); |
|
finalizeData->callback(Env(env), static_cast<ContextType*>(rawContext)); |
|
delete finalizeData; |
|
} |
|
|
|
static inline void FinalizeFinalizeWrapperWithDataAndContext( |
|
napi_env env, void* rawFinalizeData, void* rawContext) { |
|
if (rawFinalizeData == nullptr) return; |
|
|
|
ThreadSafeFinalize* finalizeData = |
|
static_cast<ThreadSafeFinalize*>(rawFinalizeData); |
|
finalizeData->callback( |
|
Env(env), finalizeData->data, static_cast<ContextType*>(rawContext)); |
|
delete finalizeData; |
|
} |
|
|
|
FinalizerDataType* data; |
|
Finalizer callback; |
|
}; |
|
|
|
template <typename ContextType, typename DataType, typename CallJs, CallJs call> |
|
inline typename std::enable_if<call != static_cast<CallJs>(nullptr)>::type |
|
CallJsWrapper(napi_env env, napi_value jsCallback, void* context, void* data) { |
|
details::WrapVoidCallback([&]() { |
|
call(env, |
|
Function(env, jsCallback), |
|
static_cast<ContextType*>(context), |
|
static_cast<DataType*>(data)); |
|
}); |
|
} |
|
|
|
template <typename ContextType, typename DataType, typename CallJs, CallJs call> |
|
inline typename std::enable_if<call == static_cast<CallJs>(nullptr)>::type |
|
CallJsWrapper(napi_env env, |
|
napi_value jsCallback, |
|
void* /*context*/, |
|
void* /*data*/) { |
|
details::WrapVoidCallback([&]() { |
|
if (jsCallback != nullptr) { |
|
Function(env, jsCallback).Call(0, nullptr); |
|
} |
|
}); |
|
} |
|
|
|
#if NAPI_VERSION > 4 |
|
|
|
template <typename CallbackType, typename TSFN> |
|
napi_value DefaultCallbackWrapper(napi_env /*env*/, std::nullptr_t /*cb*/) { |
|
return nullptr; |
|
} |
|
|
|
template <typename CallbackType, typename TSFN> |
|
napi_value DefaultCallbackWrapper(napi_env /*env*/, Napi::Function cb) { |
|
return cb; |
|
} |
|
|
|
#else |
|
template <typename CallbackType, typename TSFN> |
|
napi_value DefaultCallbackWrapper(napi_env env, Napi::Function cb) { |
|
if (cb.IsEmpty()) { |
|
return TSFN::EmptyFunctionFactory(env); |
|
} |
|
return cb; |
|
} |
|
#endif // NAPI_VERSION > 4 |
|
#endif // NAPI_VERSION > 3 && NAPI_HAS_THREADS |
|
|
|
template <typename Getter, typename Setter> |
|
struct AccessorCallbackData { |
|
static inline napi_value GetterWrapper(napi_env env, |
|
napi_callback_info info) { |
|
return details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
AccessorCallbackData* callbackData = |
|
static_cast<AccessorCallbackData*>(callbackInfo.Data()); |
|
callbackInfo.SetData(callbackData->data); |
|
return callbackData->getterCallback(callbackInfo); |
|
}); |
|
} |
|
|
|
static inline napi_value SetterWrapper(napi_env env, |
|
napi_callback_info info) { |
|
return details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
AccessorCallbackData* callbackData = |
|
static_cast<AccessorCallbackData*>(callbackInfo.Data()); |
|
callbackInfo.SetData(callbackData->data); |
|
callbackData->setterCallback(callbackInfo); |
|
return nullptr; |
|
}); |
|
} |
|
|
|
Getter getterCallback; |
|
Setter setterCallback; |
|
void* data; |
|
}; |
|
|
|
} // namespace details |
|
|
|
#ifndef NODE_ADDON_API_DISABLE_DEPRECATED |
|
#include "napi-inl.deprecated.h" |
|
#endif // !NODE_ADDON_API_DISABLE_DEPRECATED |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Module registration |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
// Register an add-on based on an initializer function. |
|
#define NODE_API_MODULE(modname, regfunc) \ |
|
static napi_value __napi_##regfunc(napi_env env, napi_value exports) { \ |
|
return Napi::RegisterModule(env, exports, regfunc); \ |
|
} \ |
|
NAPI_MODULE(modname, __napi_##regfunc) |
|
|
|
// Register an add-on based on a subclass of `Addon<T>` with a custom Node.js |
|
// module name. |
|
#define NODE_API_NAMED_ADDON(modname, classname) \ |
|
static napi_value __napi_##classname(napi_env env, napi_value exports) { \ |
|
return Napi::RegisterModule(env, exports, &classname::Init); \ |
|
} \ |
|
NAPI_MODULE(modname, __napi_##classname) |
|
|
|
// Register an add-on based on a subclass of `Addon<T>` with the Node.js module |
|
// name given by node-gyp from the `target_name` in binding.gyp. |
|
#define NODE_API_ADDON(classname) \ |
|
NODE_API_NAMED_ADDON(NODE_GYP_MODULE_NAME, classname) |
|
|
|
// Adapt the NAPI_MODULE registration function: |
|
// - Wrap the arguments in NAPI wrappers. |
|
// - Catch any NAPI errors and rethrow as JS exceptions. |
|
inline napi_value RegisterModule(napi_env env, |
|
napi_value exports, |
|
ModuleRegisterCallback registerCallback) { |
|
return details::WrapCallback([&] { |
|
return napi_value( |
|
registerCallback(Napi::Env(env), Napi::Object(env, exports))); |
|
}); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Maybe class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
template <class T> |
|
bool Maybe<T>::IsNothing() const { |
|
return !_has_value; |
|
} |
|
|
|
template <class T> |
|
bool Maybe<T>::IsJust() const { |
|
return _has_value; |
|
} |
|
|
|
template <class T> |
|
void Maybe<T>::Check() const { |
|
NAPI_CHECK(IsJust(), "Napi::Maybe::Check", "Maybe value is Nothing."); |
|
} |
|
|
|
template <class T> |
|
T Maybe<T>::Unwrap() const { |
|
NAPI_CHECK(IsJust(), "Napi::Maybe::Unwrap", "Maybe value is Nothing."); |
|
return _value; |
|
} |
|
|
|
template <class T> |
|
T Maybe<T>::UnwrapOr(const T& default_value) const { |
|
return _has_value ? _value : default_value; |
|
} |
|
|
|
template <class T> |
|
bool Maybe<T>::UnwrapTo(T* out) const { |
|
if (IsJust()) { |
|
*out = _value; |
|
return true; |
|
}; |
|
return false; |
|
} |
|
|
|
template <class T> |
|
bool Maybe<T>::operator==(const Maybe& other) const { |
|
return (IsJust() == other.IsJust()) && |
|
(!IsJust() || Unwrap() == other.Unwrap()); |
|
} |
|
|
|
template <class T> |
|
bool Maybe<T>::operator!=(const Maybe& other) const { |
|
return !operator==(other); |
|
} |
|
|
|
template <class T> |
|
Maybe<T>::Maybe() : _has_value(false) {} |
|
|
|
template <class T> |
|
Maybe<T>::Maybe(const T& t) : _has_value(true), _value(t) {} |
|
|
|
template <class T> |
|
inline Maybe<T> Nothing() { |
|
return Maybe<T>(); |
|
} |
|
|
|
template <class T> |
|
inline Maybe<T> Just(const T& t) { |
|
return Maybe<T>(t); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Env class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline Env::Env(napi_env env) : _env(env) {} |
|
|
|
inline Env::operator napi_env() const { |
|
return _env; |
|
} |
|
|
|
inline Object Env::Global() const { |
|
napi_value value; |
|
napi_status status = napi_get_global(*this, &value); |
|
NAPI_THROW_IF_FAILED(*this, status, Object()); |
|
return Object(*this, value); |
|
} |
|
|
|
inline Value Env::Undefined() const { |
|
napi_value value; |
|
napi_status status = napi_get_undefined(*this, &value); |
|
NAPI_THROW_IF_FAILED(*this, status, Value()); |
|
return Value(*this, value); |
|
} |
|
|
|
inline Value Env::Null() const { |
|
napi_value value; |
|
napi_status status = napi_get_null(*this, &value); |
|
NAPI_THROW_IF_FAILED(*this, status, Value()); |
|
return Value(*this, value); |
|
} |
|
|
|
inline bool Env::IsExceptionPending() const { |
|
bool result; |
|
napi_status status = napi_is_exception_pending(_env, &result); |
|
if (status != napi_ok) |
|
result = false; // Checking for a pending exception shouldn't throw. |
|
return result; |
|
} |
|
|
|
inline Error Env::GetAndClearPendingException() const { |
|
napi_value value; |
|
napi_status status = napi_get_and_clear_last_exception(_env, &value); |
|
if (status != napi_ok) { |
|
// Don't throw another exception when failing to get the exception! |
|
return Error(); |
|
} |
|
return Error(_env, value); |
|
} |
|
|
|
inline MaybeOrValue<Value> Env::RunScript(const char* utf8script) const { |
|
String script = String::New(_env, utf8script); |
|
return RunScript(script); |
|
} |
|
|
|
inline MaybeOrValue<Value> Env::RunScript(const std::string& utf8script) const { |
|
return RunScript(utf8script.c_str()); |
|
} |
|
|
|
inline MaybeOrValue<Value> Env::RunScript(String script) const { |
|
napi_value result; |
|
napi_status status = napi_run_script(_env, script, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED( |
|
_env, status, Napi::Value(_env, result), Napi::Value); |
|
} |
|
|
|
#if NAPI_VERSION > 2 |
|
template <typename Hook, typename Arg> |
|
void Env::CleanupHook<Hook, Arg>::Wrapper(void* data) NAPI_NOEXCEPT { |
|
auto* cleanupData = |
|
static_cast<typename Napi::Env::CleanupHook<Hook, Arg>::CleanupData*>( |
|
data); |
|
cleanupData->hook(); |
|
delete cleanupData; |
|
} |
|
|
|
template <typename Hook, typename Arg> |
|
void Env::CleanupHook<Hook, Arg>::WrapperWithArg(void* data) NAPI_NOEXCEPT { |
|
auto* cleanupData = |
|
static_cast<typename Napi::Env::CleanupHook<Hook, Arg>::CleanupData*>( |
|
data); |
|
cleanupData->hook(static_cast<Arg*>(cleanupData->arg)); |
|
delete cleanupData; |
|
} |
|
#endif // NAPI_VERSION > 2 |
|
|
|
#if NAPI_VERSION > 5 |
|
template <typename T, Env::Finalizer<T> fini> |
|
inline void Env::SetInstanceData(T* data) const { |
|
napi_status status = napi_set_instance_data( |
|
_env, |
|
data, |
|
[](napi_env env, void* data, void*) { fini(env, static_cast<T*>(data)); }, |
|
nullptr); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
template <typename DataType, |
|
typename HintType, |
|
Napi::Env::FinalizerWithHint<DataType, HintType> fini> |
|
inline void Env::SetInstanceData(DataType* data, HintType* hint) const { |
|
napi_status status = napi_set_instance_data( |
|
_env, |
|
data, |
|
[](napi_env env, void* data, void* hint) { |
|
fini(env, static_cast<DataType*>(data), static_cast<HintType*>(hint)); |
|
}, |
|
hint); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
template <typename T> |
|
inline T* Env::GetInstanceData() const { |
|
void* data = nullptr; |
|
|
|
napi_status status = napi_get_instance_data(_env, &data); |
|
NAPI_THROW_IF_FAILED(_env, status, nullptr); |
|
|
|
return static_cast<T*>(data); |
|
} |
|
|
|
template <typename T> |
|
void Env::DefaultFini(Env, T* data) { |
|
delete data; |
|
} |
|
|
|
template <typename DataType, typename HintType> |
|
void Env::DefaultFiniWithHint(Env, DataType* data, HintType*) { |
|
delete data; |
|
} |
|
#endif // NAPI_VERSION > 5 |
|
|
|
#if NAPI_VERSION > 8 |
|
inline const char* Env::GetModuleFileName() const { |
|
const char* result; |
|
napi_status status = node_api_get_module_file_name(_env, &result); |
|
NAPI_THROW_IF_FAILED(*this, status, nullptr); |
|
return result; |
|
} |
|
#endif // NAPI_VERSION > 8 |
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Value class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline Value::Value() : _env(nullptr), _value(nullptr) {} |
|
|
|
inline Value::Value(napi_env env, napi_value value) |
|
: _env(env), _value(value) {} |
|
|
|
inline Value::operator napi_value() const { |
|
return _value; |
|
} |
|
|
|
inline bool Value::operator==(const Value& other) const { |
|
return StrictEquals(other); |
|
} |
|
|
|
inline bool Value::operator!=(const Value& other) const { |
|
return !this->operator==(other); |
|
} |
|
|
|
inline bool Value::StrictEquals(const Value& other) const { |
|
bool result; |
|
napi_status status = napi_strict_equals(_env, *this, other, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, false); |
|
return result; |
|
} |
|
|
|
inline Napi::Env Value::Env() const { |
|
return Napi::Env(_env); |
|
} |
|
|
|
inline bool Value::IsEmpty() const { |
|
return _value == nullptr; |
|
} |
|
|
|
inline napi_valuetype Value::Type() const { |
|
if (IsEmpty()) { |
|
return napi_undefined; |
|
} |
|
|
|
napi_valuetype type; |
|
napi_status status = napi_typeof(_env, _value, &type); |
|
NAPI_THROW_IF_FAILED(_env, status, napi_undefined); |
|
return type; |
|
} |
|
|
|
inline bool Value::IsUndefined() const { |
|
return Type() == napi_undefined; |
|
} |
|
|
|
inline bool Value::IsNull() const { |
|
return Type() == napi_null; |
|
} |
|
|
|
inline bool Value::IsBoolean() const { |
|
return Type() == napi_boolean; |
|
} |
|
|
|
inline bool Value::IsNumber() const { |
|
return Type() == napi_number; |
|
} |
|
|
|
#if NAPI_VERSION > 5 |
|
inline bool Value::IsBigInt() const { |
|
return Type() == napi_bigint; |
|
} |
|
#endif // NAPI_VERSION > 5 |
|
|
|
#if (NAPI_VERSION > 4) |
|
inline bool Value::IsDate() const { |
|
if (IsEmpty()) { |
|
return false; |
|
} |
|
|
|
bool result; |
|
napi_status status = napi_is_date(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, false); |
|
return result; |
|
} |
|
#endif |
|
|
|
inline bool Value::IsString() const { |
|
return Type() == napi_string; |
|
} |
|
|
|
inline bool Value::IsSymbol() const { |
|
return Type() == napi_symbol; |
|
} |
|
|
|
inline bool Value::IsArray() const { |
|
if (IsEmpty()) { |
|
return false; |
|
} |
|
|
|
bool result; |
|
napi_status status = napi_is_array(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, false); |
|
return result; |
|
} |
|
|
|
inline bool Value::IsArrayBuffer() const { |
|
if (IsEmpty()) { |
|
return false; |
|
} |
|
|
|
bool result; |
|
napi_status status = napi_is_arraybuffer(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, false); |
|
return result; |
|
} |
|
|
|
inline bool Value::IsTypedArray() const { |
|
if (IsEmpty()) { |
|
return false; |
|
} |
|
|
|
bool result; |
|
napi_status status = napi_is_typedarray(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, false); |
|
return result; |
|
} |
|
|
|
inline bool Value::IsObject() const { |
|
return Type() == napi_object || IsFunction(); |
|
} |
|
|
|
inline bool Value::IsFunction() const { |
|
return Type() == napi_function; |
|
} |
|
|
|
inline bool Value::IsPromise() const { |
|
if (IsEmpty()) { |
|
return false; |
|
} |
|
|
|
bool result; |
|
napi_status status = napi_is_promise(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, false); |
|
return result; |
|
} |
|
|
|
inline bool Value::IsDataView() const { |
|
if (IsEmpty()) { |
|
return false; |
|
} |
|
|
|
bool result; |
|
napi_status status = napi_is_dataview(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, false); |
|
return result; |
|
} |
|
|
|
inline bool Value::IsBuffer() const { |
|
if (IsEmpty()) { |
|
return false; |
|
} |
|
|
|
bool result; |
|
napi_status status = napi_is_buffer(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, false); |
|
return result; |
|
} |
|
|
|
inline bool Value::IsExternal() const { |
|
return Type() == napi_external; |
|
} |
|
|
|
template <typename T> |
|
inline T Value::As() const { |
|
#ifdef NODE_ADDON_API_ENABLE_TYPE_CHECK_ON_AS |
|
T::CheckCast(_env, _value); |
|
#endif |
|
return T(_env, _value); |
|
} |
|
|
|
inline MaybeOrValue<Boolean> Value::ToBoolean() const { |
|
napi_value result; |
|
napi_status status = napi_coerce_to_bool(_env, _value, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED( |
|
_env, status, Napi::Boolean(_env, result), Napi::Boolean); |
|
} |
|
|
|
inline MaybeOrValue<Number> Value::ToNumber() const { |
|
napi_value result; |
|
napi_status status = napi_coerce_to_number(_env, _value, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED( |
|
_env, status, Napi::Number(_env, result), Napi::Number); |
|
} |
|
|
|
inline MaybeOrValue<String> Value::ToString() const { |
|
napi_value result; |
|
napi_status status = napi_coerce_to_string(_env, _value, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED( |
|
_env, status, Napi::String(_env, result), Napi::String); |
|
} |
|
|
|
inline MaybeOrValue<Object> Value::ToObject() const { |
|
napi_value result; |
|
napi_status status = napi_coerce_to_object(_env, _value, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED( |
|
_env, status, Napi::Object(_env, result), Napi::Object); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Boolean class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline Boolean Boolean::New(napi_env env, bool val) { |
|
napi_value value; |
|
napi_status status = napi_get_boolean(env, val, &value); |
|
NAPI_THROW_IF_FAILED(env, status, Boolean()); |
|
return Boolean(env, value); |
|
} |
|
|
|
inline void Boolean::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "Boolean::CheckCast", "empty value"); |
|
|
|
napi_valuetype type; |
|
napi_status status = napi_typeof(env, value, &type); |
|
NAPI_CHECK(status == napi_ok, "Boolean::CheckCast", "napi_typeof failed"); |
|
NAPI_CHECK( |
|
type == napi_boolean, "Boolean::CheckCast", "value is not napi_boolean"); |
|
} |
|
|
|
inline Boolean::Boolean() : Napi::Value() {} |
|
|
|
inline Boolean::Boolean(napi_env env, napi_value value) |
|
: Napi::Value(env, value) {} |
|
|
|
inline Boolean::operator bool() const { |
|
return Value(); |
|
} |
|
|
|
inline bool Boolean::Value() const { |
|
bool result; |
|
napi_status status = napi_get_value_bool(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, false); |
|
return result; |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Number class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline Number Number::New(napi_env env, double val) { |
|
napi_value value; |
|
napi_status status = napi_create_double(env, val, &value); |
|
NAPI_THROW_IF_FAILED(env, status, Number()); |
|
return Number(env, value); |
|
} |
|
|
|
inline void Number::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "Number::CheckCast", "empty value"); |
|
|
|
napi_valuetype type; |
|
napi_status status = napi_typeof(env, value, &type); |
|
NAPI_CHECK(status == napi_ok, "Number::CheckCast", "napi_typeof failed"); |
|
NAPI_CHECK( |
|
type == napi_number, "Number::CheckCast", "value is not napi_number"); |
|
} |
|
|
|
inline Number::Number() : Value() {} |
|
|
|
inline Number::Number(napi_env env, napi_value value) : Value(env, value) {} |
|
|
|
inline Number::operator int32_t() const { |
|
return Int32Value(); |
|
} |
|
|
|
inline Number::operator uint32_t() const { |
|
return Uint32Value(); |
|
} |
|
|
|
inline Number::operator int64_t() const { |
|
return Int64Value(); |
|
} |
|
|
|
inline Number::operator float() const { |
|
return FloatValue(); |
|
} |
|
|
|
inline Number::operator double() const { |
|
return DoubleValue(); |
|
} |
|
|
|
inline int32_t Number::Int32Value() const { |
|
int32_t result; |
|
napi_status status = napi_get_value_int32(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return result; |
|
} |
|
|
|
inline uint32_t Number::Uint32Value() const { |
|
uint32_t result; |
|
napi_status status = napi_get_value_uint32(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return result; |
|
} |
|
|
|
inline int64_t Number::Int64Value() const { |
|
int64_t result; |
|
napi_status status = napi_get_value_int64(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return result; |
|
} |
|
|
|
inline float Number::FloatValue() const { |
|
return static_cast<float>(DoubleValue()); |
|
} |
|
|
|
inline double Number::DoubleValue() const { |
|
double result; |
|
napi_status status = napi_get_value_double(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return result; |
|
} |
|
|
|
#if NAPI_VERSION > 5 |
|
//////////////////////////////////////////////////////////////////////////////// |
|
// BigInt Class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline BigInt BigInt::New(napi_env env, int64_t val) { |
|
napi_value value; |
|
napi_status status = napi_create_bigint_int64(env, val, &value); |
|
NAPI_THROW_IF_FAILED(env, status, BigInt()); |
|
return BigInt(env, value); |
|
} |
|
|
|
inline BigInt BigInt::New(napi_env env, uint64_t val) { |
|
napi_value value; |
|
napi_status status = napi_create_bigint_uint64(env, val, &value); |
|
NAPI_THROW_IF_FAILED(env, status, BigInt()); |
|
return BigInt(env, value); |
|
} |
|
|
|
inline BigInt BigInt::New(napi_env env, |
|
int sign_bit, |
|
size_t word_count, |
|
const uint64_t* words) { |
|
napi_value value; |
|
napi_status status = |
|
napi_create_bigint_words(env, sign_bit, word_count, words, &value); |
|
NAPI_THROW_IF_FAILED(env, status, BigInt()); |
|
return BigInt(env, value); |
|
} |
|
|
|
inline void BigInt::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "BigInt::CheckCast", "empty value"); |
|
|
|
napi_valuetype type; |
|
napi_status status = napi_typeof(env, value, &type); |
|
NAPI_CHECK(status == napi_ok, "BigInt::CheckCast", "napi_typeof failed"); |
|
NAPI_CHECK( |
|
type == napi_bigint, "BigInt::CheckCast", "value is not napi_bigint"); |
|
} |
|
|
|
inline BigInt::BigInt() : Value() {} |
|
|
|
inline BigInt::BigInt(napi_env env, napi_value value) : Value(env, value) {} |
|
|
|
inline int64_t BigInt::Int64Value(bool* lossless) const { |
|
int64_t result; |
|
napi_status status = |
|
napi_get_value_bigint_int64(_env, _value, &result, lossless); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return result; |
|
} |
|
|
|
inline uint64_t BigInt::Uint64Value(bool* lossless) const { |
|
uint64_t result; |
|
napi_status status = |
|
napi_get_value_bigint_uint64(_env, _value, &result, lossless); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return result; |
|
} |
|
|
|
inline size_t BigInt::WordCount() const { |
|
size_t word_count; |
|
napi_status status = |
|
napi_get_value_bigint_words(_env, _value, nullptr, &word_count, nullptr); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return word_count; |
|
} |
|
|
|
inline void BigInt::ToWords(int* sign_bit, |
|
size_t* word_count, |
|
uint64_t* words) { |
|
napi_status status = |
|
napi_get_value_bigint_words(_env, _value, sign_bit, word_count, words); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
#endif // NAPI_VERSION > 5 |
|
|
|
#if (NAPI_VERSION > 4) |
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Date Class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline Date Date::New(napi_env env, double val) { |
|
napi_value value; |
|
napi_status status = napi_create_date(env, val, &value); |
|
NAPI_THROW_IF_FAILED(env, status, Date()); |
|
return Date(env, value); |
|
} |
|
|
|
inline void Date::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "Date::CheckCast", "empty value"); |
|
|
|
bool result; |
|
napi_status status = napi_is_date(env, value, &result); |
|
NAPI_CHECK(status == napi_ok, "Date::CheckCast", "napi_is_date failed"); |
|
NAPI_CHECK(result, "Date::CheckCast", "value is not date"); |
|
} |
|
|
|
inline Date::Date() : Value() {} |
|
|
|
inline Date::Date(napi_env env, napi_value value) : Value(env, value) {} |
|
|
|
inline Date::operator double() const { |
|
return ValueOf(); |
|
} |
|
|
|
inline double Date::ValueOf() const { |
|
double result; |
|
napi_status status = napi_get_date_value(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return result; |
|
} |
|
#endif |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Name class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
inline void Name::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "Name::CheckCast", "empty value"); |
|
|
|
napi_valuetype type; |
|
napi_status status = napi_typeof(env, value, &type); |
|
NAPI_CHECK(status == napi_ok, "Name::CheckCast", "napi_typeof failed"); |
|
NAPI_CHECK(type == napi_string || type == napi_symbol, |
|
"Name::CheckCast", |
|
"value is not napi_string or napi_symbol"); |
|
} |
|
|
|
inline Name::Name() : Value() {} |
|
|
|
inline Name::Name(napi_env env, napi_value value) : Value(env, value) {} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// String class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline String String::New(napi_env env, const std::string& val) { |
|
return String::New(env, val.c_str(), val.size()); |
|
} |
|
|
|
inline String String::New(napi_env env, const std::u16string& val) { |
|
return String::New(env, val.c_str(), val.size()); |
|
} |
|
|
|
inline String String::New(napi_env env, const char* val) { |
|
// TODO(@gabrielschulhof) Remove if-statement when core's error handling is |
|
// available in all supported versions. |
|
if (val == nullptr) { |
|
// Throw an error that looks like it came from core. |
|
NAPI_THROW_IF_FAILED(env, napi_invalid_arg, String()); |
|
} |
|
napi_value value; |
|
napi_status status = |
|
napi_create_string_utf8(env, val, std::strlen(val), &value); |
|
NAPI_THROW_IF_FAILED(env, status, String()); |
|
return String(env, value); |
|
} |
|
|
|
inline String String::New(napi_env env, const char16_t* val) { |
|
napi_value value; |
|
// TODO(@gabrielschulhof) Remove if-statement when core's error handling is |
|
// available in all supported versions. |
|
if (val == nullptr) { |
|
// Throw an error that looks like it came from core. |
|
NAPI_THROW_IF_FAILED(env, napi_invalid_arg, String()); |
|
} |
|
napi_status status = |
|
napi_create_string_utf16(env, val, std::u16string(val).size(), &value); |
|
NAPI_THROW_IF_FAILED(env, status, String()); |
|
return String(env, value); |
|
} |
|
|
|
inline String String::New(napi_env env, const char* val, size_t length) { |
|
napi_value value; |
|
napi_status status = napi_create_string_utf8(env, val, length, &value); |
|
NAPI_THROW_IF_FAILED(env, status, String()); |
|
return String(env, value); |
|
} |
|
|
|
inline String String::New(napi_env env, const char16_t* val, size_t length) { |
|
napi_value value; |
|
napi_status status = napi_create_string_utf16(env, val, length, &value); |
|
NAPI_THROW_IF_FAILED(env, status, String()); |
|
return String(env, value); |
|
} |
|
|
|
inline void String::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "String::CheckCast", "empty value"); |
|
|
|
napi_valuetype type; |
|
napi_status status = napi_typeof(env, value, &type); |
|
NAPI_CHECK(status == napi_ok, "String::CheckCast", "napi_typeof failed"); |
|
NAPI_CHECK( |
|
type == napi_string, "String::CheckCast", "value is not napi_string"); |
|
} |
|
|
|
inline String::String() : Name() {} |
|
|
|
inline String::String(napi_env env, napi_value value) : Name(env, value) {} |
|
|
|
inline String::operator std::string() const { |
|
return Utf8Value(); |
|
} |
|
|
|
inline String::operator std::u16string() const { |
|
return Utf16Value(); |
|
} |
|
|
|
inline std::string String::Utf8Value() const { |
|
size_t length; |
|
napi_status status = |
|
napi_get_value_string_utf8(_env, _value, nullptr, 0, &length); |
|
NAPI_THROW_IF_FAILED(_env, status, ""); |
|
|
|
std::string value; |
|
value.reserve(length + 1); |
|
value.resize(length); |
|
status = napi_get_value_string_utf8( |
|
_env, _value, &value[0], value.capacity(), nullptr); |
|
NAPI_THROW_IF_FAILED(_env, status, ""); |
|
return value; |
|
} |
|
|
|
inline std::u16string String::Utf16Value() const { |
|
size_t length; |
|
napi_status status = |
|
napi_get_value_string_utf16(_env, _value, nullptr, 0, &length); |
|
NAPI_THROW_IF_FAILED(_env, status, NAPI_WIDE_TEXT("")); |
|
|
|
std::u16string value; |
|
value.reserve(length + 1); |
|
value.resize(length); |
|
status = napi_get_value_string_utf16( |
|
_env, _value, &value[0], value.capacity(), nullptr); |
|
NAPI_THROW_IF_FAILED(_env, status, NAPI_WIDE_TEXT("")); |
|
return value; |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Symbol class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline Symbol Symbol::New(napi_env env, const char* description) { |
|
napi_value descriptionValue = description != nullptr |
|
? String::New(env, description) |
|
: static_cast<napi_value>(nullptr); |
|
return Symbol::New(env, descriptionValue); |
|
} |
|
|
|
inline Symbol Symbol::New(napi_env env, const std::string& description) { |
|
napi_value descriptionValue = String::New(env, description); |
|
return Symbol::New(env, descriptionValue); |
|
} |
|
|
|
inline Symbol Symbol::New(napi_env env, String description) { |
|
napi_value descriptionValue = description; |
|
return Symbol::New(env, descriptionValue); |
|
} |
|
|
|
inline Symbol Symbol::New(napi_env env, napi_value description) { |
|
napi_value value; |
|
napi_status status = napi_create_symbol(env, description, &value); |
|
NAPI_THROW_IF_FAILED(env, status, Symbol()); |
|
return Symbol(env, value); |
|
} |
|
|
|
inline MaybeOrValue<Symbol> Symbol::WellKnown(napi_env env, |
|
const std::string& name) { |
|
#if defined(NODE_ADDON_API_ENABLE_MAYBE) |
|
Value symbol_obj; |
|
Value symbol_value; |
|
if (Napi::Env(env).Global().Get("Symbol").UnwrapTo(&symbol_obj) && |
|
symbol_obj.As<Object>().Get(name).UnwrapTo(&symbol_value)) { |
|
return Just<Symbol>(symbol_value.As<Symbol>()); |
|
} |
|
return Nothing<Symbol>(); |
|
#else |
|
return Napi::Env(env) |
|
.Global() |
|
.Get("Symbol") |
|
.As<Object>() |
|
.Get(name) |
|
.As<Symbol>(); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<Symbol> Symbol::For(napi_env env, |
|
const std::string& description) { |
|
napi_value descriptionValue = String::New(env, description); |
|
return Symbol::For(env, descriptionValue); |
|
} |
|
|
|
inline MaybeOrValue<Symbol> Symbol::For(napi_env env, const char* description) { |
|
napi_value descriptionValue = String::New(env, description); |
|
return Symbol::For(env, descriptionValue); |
|
} |
|
|
|
inline MaybeOrValue<Symbol> Symbol::For(napi_env env, String description) { |
|
return Symbol::For(env, static_cast<napi_value>(description)); |
|
} |
|
|
|
inline MaybeOrValue<Symbol> Symbol::For(napi_env env, napi_value description) { |
|
#if defined(NODE_ADDON_API_ENABLE_MAYBE) |
|
Value symbol_obj; |
|
Value symbol_for_value; |
|
Value symbol_value; |
|
if (Napi::Env(env).Global().Get("Symbol").UnwrapTo(&symbol_obj) && |
|
symbol_obj.As<Object>().Get("for").UnwrapTo(&symbol_for_value) && |
|
symbol_for_value.As<Function>() |
|
.Call(symbol_obj, {description}) |
|
.UnwrapTo(&symbol_value)) { |
|
return Just<Symbol>(symbol_value.As<Symbol>()); |
|
} |
|
return Nothing<Symbol>(); |
|
#else |
|
Object symbol_obj = Napi::Env(env).Global().Get("Symbol").As<Object>(); |
|
return symbol_obj.Get("for") |
|
.As<Function>() |
|
.Call(symbol_obj, {description}) |
|
.As<Symbol>(); |
|
#endif |
|
} |
|
|
|
inline void Symbol::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "Symbol::CheckCast", "empty value"); |
|
|
|
napi_valuetype type; |
|
napi_status status = napi_typeof(env, value, &type); |
|
NAPI_CHECK(status == napi_ok, "Symbol::CheckCast", "napi_typeof failed"); |
|
NAPI_CHECK( |
|
type == napi_symbol, "Symbol::CheckCast", "value is not napi_symbol"); |
|
} |
|
|
|
inline Symbol::Symbol() : Name() {} |
|
|
|
inline Symbol::Symbol(napi_env env, napi_value value) : Name(env, value) {} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Automagic value creation |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
namespace details { |
|
template <typename T> |
|
struct vf_number { |
|
static Number From(napi_env env, T value) { |
|
return Number::New(env, static_cast<double>(value)); |
|
} |
|
}; |
|
|
|
template <> |
|
struct vf_number<bool> { |
|
static Boolean From(napi_env env, bool value) { |
|
return Boolean::New(env, value); |
|
} |
|
}; |
|
|
|
struct vf_utf8_charp { |
|
static String From(napi_env env, const char* value) { |
|
return String::New(env, value); |
|
} |
|
}; |
|
|
|
struct vf_utf16_charp { |
|
static String From(napi_env env, const char16_t* value) { |
|
return String::New(env, value); |
|
} |
|
}; |
|
struct vf_utf8_string { |
|
static String From(napi_env env, const std::string& value) { |
|
return String::New(env, value); |
|
} |
|
}; |
|
|
|
struct vf_utf16_string { |
|
static String From(napi_env env, const std::u16string& value) { |
|
return String::New(env, value); |
|
} |
|
}; |
|
|
|
template <typename T> |
|
struct vf_fallback { |
|
static Value From(napi_env env, const T& value) { return Value(env, value); } |
|
}; |
|
|
|
template <typename...> |
|
struct disjunction : std::false_type {}; |
|
template <typename B> |
|
struct disjunction<B> : B {}; |
|
template <typename B, typename... Bs> |
|
struct disjunction<B, Bs...> |
|
: std::conditional<bool(B::value), B, disjunction<Bs...>>::type {}; |
|
|
|
template <typename T> |
|
struct can_make_string |
|
: disjunction<typename std::is_convertible<T, const char*>::type, |
|
typename std::is_convertible<T, const char16_t*>::type, |
|
typename std::is_convertible<T, std::string>::type, |
|
typename std::is_convertible<T, std::u16string>::type> {}; |
|
} // namespace details |
|
|
|
template <typename T> |
|
Value Value::From(napi_env env, const T& value) { |
|
using Helper = typename std::conditional< |
|
std::is_integral<T>::value || std::is_floating_point<T>::value, |
|
details::vf_number<T>, |
|
typename std::conditional<details::can_make_string<T>::value, |
|
String, |
|
details::vf_fallback<T>>::type>::type; |
|
return Helper::From(env, value); |
|
} |
|
|
|
template <typename T> |
|
String String::From(napi_env env, const T& value) { |
|
struct Dummy {}; |
|
using Helper = typename std::conditional< |
|
std::is_convertible<T, const char*>::value, |
|
details::vf_utf8_charp, |
|
typename std::conditional< |
|
std::is_convertible<T, const char16_t*>::value, |
|
details::vf_utf16_charp, |
|
typename std::conditional< |
|
std::is_convertible<T, std::string>::value, |
|
details::vf_utf8_string, |
|
typename std::conditional< |
|
std::is_convertible<T, std::u16string>::value, |
|
details::vf_utf16_string, |
|
Dummy>::type>::type>::type>::type; |
|
return Helper::From(env, value); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// TypeTaggable class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline TypeTaggable::TypeTaggable() : Value() {} |
|
|
|
inline TypeTaggable::TypeTaggable(napi_env _env, napi_value _value) |
|
: Value(_env, _value) {} |
|
|
|
#if NAPI_VERSION >= 8 |
|
|
|
inline void TypeTaggable::TypeTag(const napi_type_tag* type_tag) const { |
|
napi_status status = napi_type_tag_object(_env, _value, type_tag); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline bool TypeTaggable::CheckTypeTag(const napi_type_tag* type_tag) const { |
|
bool result; |
|
napi_status status = |
|
napi_check_object_type_tag(_env, _value, type_tag, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, false); |
|
return result; |
|
} |
|
|
|
#endif // NAPI_VERSION >= 8 |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Object class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
template <typename Key> |
|
inline Object::PropertyLValue<Key>::operator Value() const { |
|
MaybeOrValue<Value> val = Object(_env, _object).Get(_key); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
return val.Unwrap(); |
|
#else |
|
return val; |
|
#endif |
|
} |
|
|
|
template <typename Key> |
|
template <typename ValueType> |
|
inline Object::PropertyLValue<Key>& Object::PropertyLValue<Key>::operator=( |
|
ValueType value) { |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
MaybeOrValue<bool> result = |
|
#endif |
|
Object(_env, _object).Set(_key, value); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
result.Unwrap(); |
|
#endif |
|
return *this; |
|
} |
|
|
|
template <typename Key> |
|
inline Object::PropertyLValue<Key>::PropertyLValue(Object object, Key key) |
|
: _env(object.Env()), _object(object), _key(key) {} |
|
|
|
inline Object Object::New(napi_env env) { |
|
napi_value value; |
|
napi_status status = napi_create_object(env, &value); |
|
NAPI_THROW_IF_FAILED(env, status, Object()); |
|
return Object(env, value); |
|
} |
|
|
|
inline void Object::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "Object::CheckCast", "empty value"); |
|
|
|
napi_valuetype type; |
|
napi_status status = napi_typeof(env, value, &type); |
|
NAPI_CHECK(status == napi_ok, "Object::CheckCast", "napi_typeof failed"); |
|
NAPI_CHECK( |
|
type == napi_object, "Object::CheckCast", "value is not napi_object"); |
|
} |
|
|
|
inline Object::Object() : TypeTaggable() {} |
|
|
|
inline Object::Object(napi_env env, napi_value value) |
|
: TypeTaggable(env, value) {} |
|
|
|
inline Object::PropertyLValue<std::string> Object::operator[]( |
|
const char* utf8name) { |
|
return PropertyLValue<std::string>(*this, utf8name); |
|
} |
|
|
|
inline Object::PropertyLValue<std::string> Object::operator[]( |
|
const std::string& utf8name) { |
|
return PropertyLValue<std::string>(*this, utf8name); |
|
} |
|
|
|
inline Object::PropertyLValue<uint32_t> Object::operator[](uint32_t index) { |
|
return PropertyLValue<uint32_t>(*this, index); |
|
} |
|
|
|
inline Object::PropertyLValue<Value> Object::operator[](Value index) const { |
|
return PropertyLValue<Value>(*this, index); |
|
} |
|
|
|
inline MaybeOrValue<Value> Object::operator[](const char* utf8name) const { |
|
return Get(utf8name); |
|
} |
|
|
|
inline MaybeOrValue<Value> Object::operator[]( |
|
const std::string& utf8name) const { |
|
return Get(utf8name); |
|
} |
|
|
|
inline MaybeOrValue<Value> Object::operator[](uint32_t index) const { |
|
return Get(index); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::Has(napi_value key) const { |
|
bool result; |
|
napi_status status = napi_has_property(_env, _value, key, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, result, bool); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::Has(Value key) const { |
|
bool result; |
|
napi_status status = napi_has_property(_env, _value, key, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, result, bool); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::Has(const char* utf8name) const { |
|
bool result; |
|
napi_status status = napi_has_named_property(_env, _value, utf8name, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, result, bool); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::Has(const std::string& utf8name) const { |
|
return Has(utf8name.c_str()); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::HasOwnProperty(napi_value key) const { |
|
bool result; |
|
napi_status status = napi_has_own_property(_env, _value, key, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, result, bool); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::HasOwnProperty(Value key) const { |
|
bool result; |
|
napi_status status = napi_has_own_property(_env, _value, key, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, result, bool); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::HasOwnProperty(const char* utf8name) const { |
|
napi_value key; |
|
napi_status status = |
|
napi_create_string_utf8(_env, utf8name, std::strlen(utf8name), &key); |
|
NAPI_MAYBE_THROW_IF_FAILED(_env, status, bool); |
|
return HasOwnProperty(key); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::HasOwnProperty( |
|
const std::string& utf8name) const { |
|
return HasOwnProperty(utf8name.c_str()); |
|
} |
|
|
|
inline MaybeOrValue<Value> Object::Get(napi_value key) const { |
|
napi_value result; |
|
napi_status status = napi_get_property(_env, _value, key, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, Value(_env, result), Value); |
|
} |
|
|
|
inline MaybeOrValue<Value> Object::Get(Value key) const { |
|
napi_value result; |
|
napi_status status = napi_get_property(_env, _value, key, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, Value(_env, result), Value); |
|
} |
|
|
|
inline MaybeOrValue<Value> Object::Get(const char* utf8name) const { |
|
napi_value result; |
|
napi_status status = napi_get_named_property(_env, _value, utf8name, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, Value(_env, result), Value); |
|
} |
|
|
|
inline MaybeOrValue<Value> Object::Get(const std::string& utf8name) const { |
|
return Get(utf8name.c_str()); |
|
} |
|
|
|
template <typename ValueType> |
|
inline MaybeOrValue<bool> Object::Set(napi_value key, |
|
const ValueType& value) const { |
|
napi_status status = |
|
napi_set_property(_env, _value, key, Value::From(_env, value)); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, status == napi_ok, bool); |
|
} |
|
|
|
template <typename ValueType> |
|
inline MaybeOrValue<bool> Object::Set(Value key, const ValueType& value) const { |
|
napi_status status = |
|
napi_set_property(_env, _value, key, Value::From(_env, value)); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, status == napi_ok, bool); |
|
} |
|
|
|
template <typename ValueType> |
|
inline MaybeOrValue<bool> Object::Set(const char* utf8name, |
|
const ValueType& value) const { |
|
napi_status status = |
|
napi_set_named_property(_env, _value, utf8name, Value::From(_env, value)); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, status == napi_ok, bool); |
|
} |
|
|
|
template <typename ValueType> |
|
inline MaybeOrValue<bool> Object::Set(const std::string& utf8name, |
|
const ValueType& value) const { |
|
return Set(utf8name.c_str(), value); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::Delete(napi_value key) const { |
|
bool result; |
|
napi_status status = napi_delete_property(_env, _value, key, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, result, bool); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::Delete(Value key) const { |
|
bool result; |
|
napi_status status = napi_delete_property(_env, _value, key, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, result, bool); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::Delete(const char* utf8name) const { |
|
return Delete(String::New(_env, utf8name)); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::Delete(const std::string& utf8name) const { |
|
return Delete(String::New(_env, utf8name)); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::Has(uint32_t index) const { |
|
bool result; |
|
napi_status status = napi_has_element(_env, _value, index, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, result, bool); |
|
} |
|
|
|
inline MaybeOrValue<Value> Object::Get(uint32_t index) const { |
|
napi_value value; |
|
napi_status status = napi_get_element(_env, _value, index, &value); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, Value(_env, value), Value); |
|
} |
|
|
|
template <typename ValueType> |
|
inline MaybeOrValue<bool> Object::Set(uint32_t index, |
|
const ValueType& value) const { |
|
napi_status status = |
|
napi_set_element(_env, _value, index, Value::From(_env, value)); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, status == napi_ok, bool); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::Delete(uint32_t index) const { |
|
bool result; |
|
napi_status status = napi_delete_element(_env, _value, index, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, result, bool); |
|
} |
|
|
|
inline MaybeOrValue<Array> Object::GetPropertyNames() const { |
|
napi_value result; |
|
napi_status status = napi_get_property_names(_env, _value, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, Array(_env, result), Array); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::DefineProperty( |
|
const PropertyDescriptor& property) const { |
|
napi_status status = napi_define_properties( |
|
_env, |
|
_value, |
|
1, |
|
reinterpret_cast<const napi_property_descriptor*>(&property)); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, status == napi_ok, bool); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::DefineProperties( |
|
const std::initializer_list<PropertyDescriptor>& properties) const { |
|
napi_status status = napi_define_properties( |
|
_env, |
|
_value, |
|
properties.size(), |
|
reinterpret_cast<const napi_property_descriptor*>(properties.begin())); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, status == napi_ok, bool); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::DefineProperties( |
|
const std::vector<PropertyDescriptor>& properties) const { |
|
napi_status status = napi_define_properties( |
|
_env, |
|
_value, |
|
properties.size(), |
|
reinterpret_cast<const napi_property_descriptor*>(properties.data())); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, status == napi_ok, bool); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::InstanceOf( |
|
const Function& constructor) const { |
|
bool result; |
|
napi_status status = napi_instanceof(_env, _value, constructor, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, result, bool); |
|
} |
|
|
|
template <typename Finalizer, typename T> |
|
inline void Object::AddFinalizer(Finalizer finalizeCallback, T* data) const { |
|
details::FinalizeData<T, Finalizer>* finalizeData = |
|
new details::FinalizeData<T, Finalizer>( |
|
{std::move(finalizeCallback), nullptr}); |
|
napi_status status = |
|
details::AttachData<T, details::FinalizeData<T, Finalizer>::Wrapper>( |
|
_env, *this, data, finalizeData); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
} |
|
|
|
template <typename Finalizer, typename T, typename Hint> |
|
inline void Object::AddFinalizer(Finalizer finalizeCallback, |
|
T* data, |
|
Hint* finalizeHint) const { |
|
details::FinalizeData<T, Finalizer, Hint>* finalizeData = |
|
new details::FinalizeData<T, Finalizer, Hint>( |
|
{std::move(finalizeCallback), finalizeHint}); |
|
napi_status status = details:: |
|
AttachData<T, details::FinalizeData<T, Finalizer, Hint>::WrapperWithHint>( |
|
_env, *this, data, finalizeData); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
} |
|
|
|
#ifdef NAPI_CPP_EXCEPTIONS |
|
inline Object::const_iterator::const_iterator(const Object* object, |
|
const Type type) { |
|
_object = object; |
|
_keys = object->GetPropertyNames(); |
|
_index = type == Type::BEGIN ? 0 : _keys.Length(); |
|
} |
|
|
|
inline Object::const_iterator Napi::Object::begin() const { |
|
const_iterator it(this, Object::const_iterator::Type::BEGIN); |
|
return it; |
|
} |
|
|
|
inline Object::const_iterator Napi::Object::end() const { |
|
const_iterator it(this, Object::const_iterator::Type::END); |
|
return it; |
|
} |
|
|
|
inline Object::const_iterator& Object::const_iterator::operator++() { |
|
++_index; |
|
return *this; |
|
} |
|
|
|
inline bool Object::const_iterator::operator==( |
|
const const_iterator& other) const { |
|
return _index == other._index; |
|
} |
|
|
|
inline bool Object::const_iterator::operator!=( |
|
const const_iterator& other) const { |
|
return _index != other._index; |
|
} |
|
|
|
inline const std::pair<Value, Object::PropertyLValue<Value>> |
|
Object::const_iterator::operator*() const { |
|
const Value key = _keys[_index]; |
|
const PropertyLValue<Value> value = (*_object)[key]; |
|
return {key, value}; |
|
} |
|
|
|
inline Object::iterator::iterator(Object* object, const Type type) { |
|
_object = object; |
|
_keys = object->GetPropertyNames(); |
|
_index = type == Type::BEGIN ? 0 : _keys.Length(); |
|
} |
|
|
|
inline Object::iterator Napi::Object::begin() { |
|
iterator it(this, Object::iterator::Type::BEGIN); |
|
return it; |
|
} |
|
|
|
inline Object::iterator Napi::Object::end() { |
|
iterator it(this, Object::iterator::Type::END); |
|
return it; |
|
} |
|
|
|
inline Object::iterator& Object::iterator::operator++() { |
|
++_index; |
|
return *this; |
|
} |
|
|
|
inline bool Object::iterator::operator==(const iterator& other) const { |
|
return _index == other._index; |
|
} |
|
|
|
inline bool Object::iterator::operator!=(const iterator& other) const { |
|
return _index != other._index; |
|
} |
|
|
|
inline std::pair<Value, Object::PropertyLValue<Value>> |
|
Object::iterator::operator*() { |
|
Value key = _keys[_index]; |
|
PropertyLValue<Value> value = (*_object)[key]; |
|
return {key, value}; |
|
} |
|
#endif // NAPI_CPP_EXCEPTIONS |
|
|
|
#if NAPI_VERSION >= 8 |
|
inline MaybeOrValue<bool> Object::Freeze() const { |
|
napi_status status = napi_object_freeze(_env, _value); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, status == napi_ok, bool); |
|
} |
|
|
|
inline MaybeOrValue<bool> Object::Seal() const { |
|
napi_status status = napi_object_seal(_env, _value); |
|
NAPI_RETURN_OR_THROW_IF_FAILED(_env, status, status == napi_ok, bool); |
|
} |
|
#endif // NAPI_VERSION >= 8 |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// External class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
template <typename T> |
|
inline External<T> External<T>::New(napi_env env, T* data) { |
|
napi_value value; |
|
napi_status status = |
|
napi_create_external(env, data, nullptr, nullptr, &value); |
|
NAPI_THROW_IF_FAILED(env, status, External()); |
|
return External(env, value); |
|
} |
|
|
|
template <typename T> |
|
template <typename Finalizer> |
|
inline External<T> External<T>::New(napi_env env, |
|
T* data, |
|
Finalizer finalizeCallback) { |
|
napi_value value; |
|
details::FinalizeData<T, Finalizer>* finalizeData = |
|
new details::FinalizeData<T, Finalizer>( |
|
{std::move(finalizeCallback), nullptr}); |
|
napi_status status = |
|
napi_create_external(env, |
|
data, |
|
details::FinalizeData<T, Finalizer>::Wrapper, |
|
finalizeData, |
|
&value); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED(env, status, External()); |
|
} |
|
return External(env, value); |
|
} |
|
|
|
template <typename T> |
|
template <typename Finalizer, typename Hint> |
|
inline External<T> External<T>::New(napi_env env, |
|
T* data, |
|
Finalizer finalizeCallback, |
|
Hint* finalizeHint) { |
|
napi_value value; |
|
details::FinalizeData<T, Finalizer, Hint>* finalizeData = |
|
new details::FinalizeData<T, Finalizer, Hint>( |
|
{std::move(finalizeCallback), finalizeHint}); |
|
napi_status status = napi_create_external( |
|
env, |
|
data, |
|
details::FinalizeData<T, Finalizer, Hint>::WrapperWithHint, |
|
finalizeData, |
|
&value); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED(env, status, External()); |
|
} |
|
return External(env, value); |
|
} |
|
|
|
template <typename T> |
|
inline void External<T>::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "External::CheckCast", "empty value"); |
|
|
|
napi_valuetype type; |
|
napi_status status = napi_typeof(env, value, &type); |
|
NAPI_CHECK(status == napi_ok, "External::CheckCast", "napi_typeof failed"); |
|
NAPI_CHECK(type == napi_external, |
|
"External::CheckCast", |
|
"value is not napi_external"); |
|
} |
|
|
|
template <typename T> |
|
inline External<T>::External() : TypeTaggable() {} |
|
|
|
template <typename T> |
|
inline External<T>::External(napi_env env, napi_value value) |
|
: TypeTaggable(env, value) {} |
|
|
|
template <typename T> |
|
inline T* External<T>::Data() const { |
|
void* data; |
|
napi_status status = napi_get_value_external(_env, _value, &data); |
|
NAPI_THROW_IF_FAILED(_env, status, nullptr); |
|
return reinterpret_cast<T*>(data); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Array class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline Array Array::New(napi_env env) { |
|
napi_value value; |
|
napi_status status = napi_create_array(env, &value); |
|
NAPI_THROW_IF_FAILED(env, status, Array()); |
|
return Array(env, value); |
|
} |
|
|
|
inline Array Array::New(napi_env env, size_t length) { |
|
napi_value value; |
|
napi_status status = napi_create_array_with_length(env, length, &value); |
|
NAPI_THROW_IF_FAILED(env, status, Array()); |
|
return Array(env, value); |
|
} |
|
|
|
inline void Array::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "Array::CheckCast", "empty value"); |
|
|
|
bool result; |
|
napi_status status = napi_is_array(env, value, &result); |
|
NAPI_CHECK(status == napi_ok, "Array::CheckCast", "napi_is_array failed"); |
|
NAPI_CHECK(result, "Array::CheckCast", "value is not array"); |
|
} |
|
|
|
inline Array::Array() : Object() {} |
|
|
|
inline Array::Array(napi_env env, napi_value value) : Object(env, value) {} |
|
|
|
inline uint32_t Array::Length() const { |
|
uint32_t result; |
|
napi_status status = napi_get_array_length(_env, _value, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return result; |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// ArrayBuffer class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline ArrayBuffer ArrayBuffer::New(napi_env env, size_t byteLength) { |
|
napi_value value; |
|
void* data; |
|
napi_status status = napi_create_arraybuffer(env, byteLength, &data, &value); |
|
NAPI_THROW_IF_FAILED(env, status, ArrayBuffer()); |
|
|
|
return ArrayBuffer(env, value); |
|
} |
|
|
|
#ifndef NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
inline ArrayBuffer ArrayBuffer::New(napi_env env, |
|
void* externalData, |
|
size_t byteLength) { |
|
napi_value value; |
|
napi_status status = napi_create_external_arraybuffer( |
|
env, externalData, byteLength, nullptr, nullptr, &value); |
|
NAPI_THROW_IF_FAILED(env, status, ArrayBuffer()); |
|
|
|
return ArrayBuffer(env, value); |
|
} |
|
|
|
template <typename Finalizer> |
|
inline ArrayBuffer ArrayBuffer::New(napi_env env, |
|
void* externalData, |
|
size_t byteLength, |
|
Finalizer finalizeCallback) { |
|
napi_value value; |
|
details::FinalizeData<void, Finalizer>* finalizeData = |
|
new details::FinalizeData<void, Finalizer>( |
|
{std::move(finalizeCallback), nullptr}); |
|
napi_status status = napi_create_external_arraybuffer( |
|
env, |
|
externalData, |
|
byteLength, |
|
details::FinalizeData<void, Finalizer>::Wrapper, |
|
finalizeData, |
|
&value); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED(env, status, ArrayBuffer()); |
|
} |
|
|
|
return ArrayBuffer(env, value); |
|
} |
|
|
|
template <typename Finalizer, typename Hint> |
|
inline ArrayBuffer ArrayBuffer::New(napi_env env, |
|
void* externalData, |
|
size_t byteLength, |
|
Finalizer finalizeCallback, |
|
Hint* finalizeHint) { |
|
napi_value value; |
|
details::FinalizeData<void, Finalizer, Hint>* finalizeData = |
|
new details::FinalizeData<void, Finalizer, Hint>( |
|
{std::move(finalizeCallback), finalizeHint}); |
|
napi_status status = napi_create_external_arraybuffer( |
|
env, |
|
externalData, |
|
byteLength, |
|
details::FinalizeData<void, Finalizer, Hint>::WrapperWithHint, |
|
finalizeData, |
|
&value); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED(env, status, ArrayBuffer()); |
|
} |
|
|
|
return ArrayBuffer(env, value); |
|
} |
|
#endif // NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
|
|
inline void ArrayBuffer::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "ArrayBuffer::CheckCast", "empty value"); |
|
|
|
bool result; |
|
napi_status status = napi_is_arraybuffer(env, value, &result); |
|
NAPI_CHECK(status == napi_ok, |
|
"ArrayBuffer::CheckCast", |
|
"napi_is_arraybuffer failed"); |
|
NAPI_CHECK(result, "ArrayBuffer::CheckCast", "value is not arraybuffer"); |
|
} |
|
|
|
inline ArrayBuffer::ArrayBuffer() : Object() {} |
|
|
|
inline ArrayBuffer::ArrayBuffer(napi_env env, napi_value value) |
|
: Object(env, value) {} |
|
|
|
inline void* ArrayBuffer::Data() { |
|
void* data; |
|
napi_status status = napi_get_arraybuffer_info(_env, _value, &data, nullptr); |
|
NAPI_THROW_IF_FAILED(_env, status, nullptr); |
|
return data; |
|
} |
|
|
|
inline size_t ArrayBuffer::ByteLength() { |
|
size_t length; |
|
napi_status status = |
|
napi_get_arraybuffer_info(_env, _value, nullptr, &length); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return length; |
|
} |
|
|
|
#if NAPI_VERSION >= 7 |
|
inline bool ArrayBuffer::IsDetached() const { |
|
bool detached; |
|
napi_status status = napi_is_detached_arraybuffer(_env, _value, &detached); |
|
NAPI_THROW_IF_FAILED(_env, status, false); |
|
return detached; |
|
} |
|
|
|
inline void ArrayBuffer::Detach() { |
|
napi_status status = napi_detach_arraybuffer(_env, _value); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
#endif // NAPI_VERSION >= 7 |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// DataView class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
inline DataView DataView::New(napi_env env, Napi::ArrayBuffer arrayBuffer) { |
|
return New(env, arrayBuffer, 0, arrayBuffer.ByteLength()); |
|
} |
|
|
|
inline DataView DataView::New(napi_env env, |
|
Napi::ArrayBuffer arrayBuffer, |
|
size_t byteOffset) { |
|
if (byteOffset > arrayBuffer.ByteLength()) { |
|
NAPI_THROW(RangeError::New( |
|
env, "Start offset is outside the bounds of the buffer"), |
|
DataView()); |
|
} |
|
return New( |
|
env, arrayBuffer, byteOffset, arrayBuffer.ByteLength() - byteOffset); |
|
} |
|
|
|
inline DataView DataView::New(napi_env env, |
|
Napi::ArrayBuffer arrayBuffer, |
|
size_t byteOffset, |
|
size_t byteLength) { |
|
if (byteOffset + byteLength > arrayBuffer.ByteLength()) { |
|
NAPI_THROW(RangeError::New(env, "Invalid DataView length"), DataView()); |
|
} |
|
napi_value value; |
|
napi_status status = |
|
napi_create_dataview(env, byteLength, arrayBuffer, byteOffset, &value); |
|
NAPI_THROW_IF_FAILED(env, status, DataView()); |
|
return DataView(env, value); |
|
} |
|
|
|
inline void DataView::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "DataView::CheckCast", "empty value"); |
|
|
|
bool result; |
|
napi_status status = napi_is_dataview(env, value, &result); |
|
NAPI_CHECK( |
|
status == napi_ok, "DataView::CheckCast", "napi_is_dataview failed"); |
|
NAPI_CHECK(result, "DataView::CheckCast", "value is not dataview"); |
|
} |
|
|
|
inline DataView::DataView() : Object() {} |
|
|
|
inline DataView::DataView(napi_env env, napi_value value) : Object(env, value) { |
|
napi_status status = napi_get_dataview_info(_env, |
|
_value /* dataView */, |
|
&_length /* byteLength */, |
|
&_data /* data */, |
|
nullptr /* arrayBuffer */, |
|
nullptr /* byteOffset */); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline Napi::ArrayBuffer DataView::ArrayBuffer() const { |
|
napi_value arrayBuffer; |
|
napi_status status = napi_get_dataview_info(_env, |
|
_value /* dataView */, |
|
nullptr /* byteLength */, |
|
nullptr /* data */, |
|
&arrayBuffer /* arrayBuffer */, |
|
nullptr /* byteOffset */); |
|
NAPI_THROW_IF_FAILED(_env, status, Napi::ArrayBuffer()); |
|
return Napi::ArrayBuffer(_env, arrayBuffer); |
|
} |
|
|
|
inline size_t DataView::ByteOffset() const { |
|
size_t byteOffset; |
|
napi_status status = napi_get_dataview_info(_env, |
|
_value /* dataView */, |
|
nullptr /* byteLength */, |
|
nullptr /* data */, |
|
nullptr /* arrayBuffer */, |
|
&byteOffset /* byteOffset */); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return byteOffset; |
|
} |
|
|
|
inline size_t DataView::ByteLength() const { |
|
return _length; |
|
} |
|
|
|
inline void* DataView::Data() const { |
|
return _data; |
|
} |
|
|
|
inline float DataView::GetFloat32(size_t byteOffset) const { |
|
return ReadData<float>(byteOffset); |
|
} |
|
|
|
inline double DataView::GetFloat64(size_t byteOffset) const { |
|
return ReadData<double>(byteOffset); |
|
} |
|
|
|
inline int8_t DataView::GetInt8(size_t byteOffset) const { |
|
return ReadData<int8_t>(byteOffset); |
|
} |
|
|
|
inline int16_t DataView::GetInt16(size_t byteOffset) const { |
|
return ReadData<int16_t>(byteOffset); |
|
} |
|
|
|
inline int32_t DataView::GetInt32(size_t byteOffset) const { |
|
return ReadData<int32_t>(byteOffset); |
|
} |
|
|
|
inline uint8_t DataView::GetUint8(size_t byteOffset) const { |
|
return ReadData<uint8_t>(byteOffset); |
|
} |
|
|
|
inline uint16_t DataView::GetUint16(size_t byteOffset) const { |
|
return ReadData<uint16_t>(byteOffset); |
|
} |
|
|
|
inline uint32_t DataView::GetUint32(size_t byteOffset) const { |
|
return ReadData<uint32_t>(byteOffset); |
|
} |
|
|
|
inline void DataView::SetFloat32(size_t byteOffset, float value) const { |
|
WriteData<float>(byteOffset, value); |
|
} |
|
|
|
inline void DataView::SetFloat64(size_t byteOffset, double value) const { |
|
WriteData<double>(byteOffset, value); |
|
} |
|
|
|
inline void DataView::SetInt8(size_t byteOffset, int8_t value) const { |
|
WriteData<int8_t>(byteOffset, value); |
|
} |
|
|
|
inline void DataView::SetInt16(size_t byteOffset, int16_t value) const { |
|
WriteData<int16_t>(byteOffset, value); |
|
} |
|
|
|
inline void DataView::SetInt32(size_t byteOffset, int32_t value) const { |
|
WriteData<int32_t>(byteOffset, value); |
|
} |
|
|
|
inline void DataView::SetUint8(size_t byteOffset, uint8_t value) const { |
|
WriteData<uint8_t>(byteOffset, value); |
|
} |
|
|
|
inline void DataView::SetUint16(size_t byteOffset, uint16_t value) const { |
|
WriteData<uint16_t>(byteOffset, value); |
|
} |
|
|
|
inline void DataView::SetUint32(size_t byteOffset, uint32_t value) const { |
|
WriteData<uint32_t>(byteOffset, value); |
|
} |
|
|
|
template <typename T> |
|
inline T DataView::ReadData(size_t byteOffset) const { |
|
if (byteOffset + sizeof(T) > _length || |
|
byteOffset + sizeof(T) < byteOffset) { // overflow |
|
NAPI_THROW( |
|
RangeError::New(_env, "Offset is outside the bounds of the DataView"), |
|
0); |
|
} |
|
|
|
return *reinterpret_cast<T*>(static_cast<uint8_t*>(_data) + byteOffset); |
|
} |
|
|
|
template <typename T> |
|
inline void DataView::WriteData(size_t byteOffset, T value) const { |
|
if (byteOffset + sizeof(T) > _length || |
|
byteOffset + sizeof(T) < byteOffset) { // overflow |
|
NAPI_THROW_VOID( |
|
RangeError::New(_env, "Offset is outside the bounds of the DataView")); |
|
} |
|
|
|
*reinterpret_cast<T*>(static_cast<uint8_t*>(_data) + byteOffset) = value; |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// TypedArray class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
inline void TypedArray::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "TypedArray::CheckCast", "empty value"); |
|
|
|
bool result; |
|
napi_status status = napi_is_typedarray(env, value, &result); |
|
NAPI_CHECK( |
|
status == napi_ok, "TypedArray::CheckCast", "napi_is_typedarray failed"); |
|
NAPI_CHECK(result, "TypedArray::CheckCast", "value is not typedarray"); |
|
} |
|
|
|
inline TypedArray::TypedArray() |
|
: Object(), _type(napi_typedarray_type::napi_int8_array), _length(0) {} |
|
|
|
inline TypedArray::TypedArray(napi_env env, napi_value value) |
|
: Object(env, value), |
|
_type(napi_typedarray_type::napi_int8_array), |
|
_length(0) { |
|
if (value != nullptr) { |
|
napi_status status = |
|
napi_get_typedarray_info(_env, |
|
_value, |
|
&const_cast<TypedArray*>(this)->_type, |
|
&const_cast<TypedArray*>(this)->_length, |
|
nullptr, |
|
nullptr, |
|
nullptr); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
} |
|
|
|
inline TypedArray::TypedArray(napi_env env, |
|
napi_value value, |
|
napi_typedarray_type type, |
|
size_t length) |
|
: Object(env, value), _type(type), _length(length) {} |
|
|
|
inline napi_typedarray_type TypedArray::TypedArrayType() const { |
|
return _type; |
|
} |
|
|
|
inline uint8_t TypedArray::ElementSize() const { |
|
switch (_type) { |
|
case napi_int8_array: |
|
case napi_uint8_array: |
|
case napi_uint8_clamped_array: |
|
return 1; |
|
case napi_int16_array: |
|
case napi_uint16_array: |
|
return 2; |
|
case napi_int32_array: |
|
case napi_uint32_array: |
|
case napi_float32_array: |
|
return 4; |
|
case napi_float64_array: |
|
#if (NAPI_VERSION > 5) |
|
case napi_bigint64_array: |
|
case napi_biguint64_array: |
|
#endif // (NAPI_VERSION > 5) |
|
return 8; |
|
default: |
|
return 0; |
|
} |
|
} |
|
|
|
inline size_t TypedArray::ElementLength() const { |
|
return _length; |
|
} |
|
|
|
inline size_t TypedArray::ByteOffset() const { |
|
size_t byteOffset; |
|
napi_status status = napi_get_typedarray_info( |
|
_env, _value, nullptr, nullptr, nullptr, nullptr, &byteOffset); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return byteOffset; |
|
} |
|
|
|
inline size_t TypedArray::ByteLength() const { |
|
return ElementSize() * ElementLength(); |
|
} |
|
|
|
inline Napi::ArrayBuffer TypedArray::ArrayBuffer() const { |
|
napi_value arrayBuffer; |
|
napi_status status = napi_get_typedarray_info( |
|
_env, _value, nullptr, nullptr, nullptr, &arrayBuffer, nullptr); |
|
NAPI_THROW_IF_FAILED(_env, status, Napi::ArrayBuffer()); |
|
return Napi::ArrayBuffer(_env, arrayBuffer); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// TypedArrayOf<T> class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
template <typename T> |
|
inline void TypedArrayOf<T>::CheckCast(napi_env env, napi_value value) { |
|
TypedArray::CheckCast(env, value); |
|
napi_typedarray_type type; |
|
napi_status status = napi_get_typedarray_info( |
|
env, value, &type, nullptr, nullptr, nullptr, nullptr); |
|
NAPI_CHECK(status == napi_ok, |
|
"TypedArrayOf::CheckCast", |
|
"napi_is_typedarray failed"); |
|
|
|
NAPI_CHECK( |
|
(type == TypedArrayTypeForPrimitiveType<T>() || |
|
(type == napi_uint8_clamped_array && std::is_same<T, uint8_t>::value)), |
|
"TypedArrayOf::CheckCast", |
|
"Array type must match the template parameter. (Uint8 arrays may " |
|
"optionally have the \"clamped\" array type.)"); |
|
} |
|
|
|
template <typename T> |
|
inline TypedArrayOf<T> TypedArrayOf<T>::New(napi_env env, |
|
size_t elementLength, |
|
napi_typedarray_type type) { |
|
Napi::ArrayBuffer arrayBuffer = |
|
Napi::ArrayBuffer::New(env, elementLength * sizeof(T)); |
|
return New(env, elementLength, arrayBuffer, 0, type); |
|
} |
|
|
|
template <typename T> |
|
inline TypedArrayOf<T> TypedArrayOf<T>::New(napi_env env, |
|
size_t elementLength, |
|
Napi::ArrayBuffer arrayBuffer, |
|
size_t bufferOffset, |
|
napi_typedarray_type type) { |
|
napi_value value; |
|
napi_status status = napi_create_typedarray( |
|
env, type, elementLength, arrayBuffer, bufferOffset, &value); |
|
NAPI_THROW_IF_FAILED(env, status, TypedArrayOf<T>()); |
|
|
|
return TypedArrayOf<T>( |
|
env, |
|
value, |
|
type, |
|
elementLength, |
|
reinterpret_cast<T*>(reinterpret_cast<uint8_t*>(arrayBuffer.Data()) + |
|
bufferOffset)); |
|
} |
|
|
|
template <typename T> |
|
inline TypedArrayOf<T>::TypedArrayOf() : TypedArray(), _data(nullptr) {} |
|
|
|
template <typename T> |
|
inline TypedArrayOf<T>::TypedArrayOf(napi_env env, napi_value value) |
|
: TypedArray(env, value), _data(nullptr) { |
|
napi_status status = napi_ok; |
|
if (value != nullptr) { |
|
void* data = nullptr; |
|
status = napi_get_typedarray_info( |
|
_env, _value, &_type, &_length, &data, nullptr, nullptr); |
|
_data = static_cast<T*>(data); |
|
} else { |
|
_type = TypedArrayTypeForPrimitiveType<T>(); |
|
_length = 0; |
|
} |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
template <typename T> |
|
inline TypedArrayOf<T>::TypedArrayOf(napi_env env, |
|
napi_value value, |
|
napi_typedarray_type type, |
|
size_t length, |
|
T* data) |
|
: TypedArray(env, value, type, length), _data(data) { |
|
if (!(type == TypedArrayTypeForPrimitiveType<T>() || |
|
(type == napi_uint8_clamped_array && |
|
std::is_same<T, uint8_t>::value))) { |
|
NAPI_THROW_VOID(TypeError::New( |
|
env, |
|
"Array type must match the template parameter. " |
|
"(Uint8 arrays may optionally have the \"clamped\" array type.)")); |
|
} |
|
} |
|
|
|
template <typename T> |
|
inline T& TypedArrayOf<T>::operator[](size_t index) { |
|
return _data[index]; |
|
} |
|
|
|
template <typename T> |
|
inline const T& TypedArrayOf<T>::operator[](size_t index) const { |
|
return _data[index]; |
|
} |
|
|
|
template <typename T> |
|
inline T* TypedArrayOf<T>::Data() { |
|
return _data; |
|
} |
|
|
|
template <typename T> |
|
inline const T* TypedArrayOf<T>::Data() const { |
|
return _data; |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Function class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
template <typename CbData> |
|
inline napi_status CreateFunction(napi_env env, |
|
const char* utf8name, |
|
napi_callback cb, |
|
CbData* data, |
|
napi_value* result) { |
|
napi_status status = |
|
napi_create_function(env, utf8name, NAPI_AUTO_LENGTH, cb, data, result); |
|
if (status == napi_ok) { |
|
status = Napi::details::AttachData(env, *result, data); |
|
} |
|
|
|
return status; |
|
} |
|
|
|
template <Function::VoidCallback cb> |
|
inline Function Function::New(napi_env env, const char* utf8name, void* data) { |
|
napi_value result = nullptr; |
|
napi_status status = napi_create_function(env, |
|
utf8name, |
|
NAPI_AUTO_LENGTH, |
|
details::TemplatedVoidCallback<cb>, |
|
data, |
|
&result); |
|
NAPI_THROW_IF_FAILED(env, status, Function()); |
|
return Function(env, result); |
|
} |
|
|
|
template <Function::Callback cb> |
|
inline Function Function::New(napi_env env, const char* utf8name, void* data) { |
|
napi_value result = nullptr; |
|
napi_status status = napi_create_function(env, |
|
utf8name, |
|
NAPI_AUTO_LENGTH, |
|
details::TemplatedCallback<cb>, |
|
data, |
|
&result); |
|
NAPI_THROW_IF_FAILED(env, status, Function()); |
|
return Function(env, result); |
|
} |
|
|
|
template <Function::VoidCallback cb> |
|
inline Function Function::New(napi_env env, |
|
const std::string& utf8name, |
|
void* data) { |
|
return Function::New<cb>(env, utf8name.c_str(), data); |
|
} |
|
|
|
template <Function::Callback cb> |
|
inline Function Function::New(napi_env env, |
|
const std::string& utf8name, |
|
void* data) { |
|
return Function::New<cb>(env, utf8name.c_str(), data); |
|
} |
|
|
|
template <typename Callable> |
|
inline Function Function::New(napi_env env, |
|
Callable cb, |
|
const char* utf8name, |
|
void* data) { |
|
using ReturnType = decltype(cb(CallbackInfo(nullptr, nullptr))); |
|
using CbData = details::CallbackData<Callable, ReturnType>; |
|
auto callbackData = new CbData{std::move(cb), data}; |
|
|
|
napi_value value; |
|
napi_status status = |
|
CreateFunction(env, utf8name, CbData::Wrapper, callbackData, &value); |
|
if (status != napi_ok) { |
|
delete callbackData; |
|
NAPI_THROW_IF_FAILED(env, status, Function()); |
|
} |
|
|
|
return Function(env, value); |
|
} |
|
|
|
template <typename Callable> |
|
inline Function Function::New(napi_env env, |
|
Callable cb, |
|
const std::string& utf8name, |
|
void* data) { |
|
return New(env, cb, utf8name.c_str(), data); |
|
} |
|
|
|
inline void Function::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "Function::CheckCast", "empty value"); |
|
|
|
napi_valuetype type; |
|
napi_status status = napi_typeof(env, value, &type); |
|
NAPI_CHECK(status == napi_ok, "Function::CheckCast", "napi_typeof failed"); |
|
NAPI_CHECK(type == napi_function, |
|
"Function::CheckCast", |
|
"value is not napi_function"); |
|
} |
|
|
|
inline Function::Function() : Object() {} |
|
|
|
inline Function::Function(napi_env env, napi_value value) |
|
: Object(env, value) {} |
|
|
|
inline MaybeOrValue<Value> Function::operator()( |
|
const std::initializer_list<napi_value>& args) const { |
|
return Call(Env().Undefined(), args); |
|
} |
|
|
|
inline MaybeOrValue<Value> Function::Call( |
|
const std::initializer_list<napi_value>& args) const { |
|
return Call(Env().Undefined(), args); |
|
} |
|
|
|
inline MaybeOrValue<Value> Function::Call( |
|
const std::vector<napi_value>& args) const { |
|
return Call(Env().Undefined(), args); |
|
} |
|
|
|
inline MaybeOrValue<Value> Function::Call( |
|
const std::vector<Value>& args) const { |
|
return Call(Env().Undefined(), args); |
|
} |
|
|
|
inline MaybeOrValue<Value> Function::Call(size_t argc, |
|
const napi_value* args) const { |
|
return Call(Env().Undefined(), argc, args); |
|
} |
|
|
|
inline MaybeOrValue<Value> Function::Call( |
|
napi_value recv, const std::initializer_list<napi_value>& args) const { |
|
return Call(recv, args.size(), args.begin()); |
|
} |
|
|
|
inline MaybeOrValue<Value> Function::Call( |
|
napi_value recv, const std::vector<napi_value>& args) const { |
|
return Call(recv, args.size(), args.data()); |
|
} |
|
|
|
inline MaybeOrValue<Value> Function::Call( |
|
napi_value recv, const std::vector<Value>& args) const { |
|
const size_t argc = args.size(); |
|
const size_t stackArgsCount = 6; |
|
napi_value stackArgs[stackArgsCount]; |
|
std::vector<napi_value> heapArgs; |
|
napi_value* argv; |
|
if (argc <= stackArgsCount) { |
|
argv = stackArgs; |
|
} else { |
|
heapArgs.resize(argc); |
|
argv = heapArgs.data(); |
|
} |
|
|
|
for (size_t index = 0; index < argc; index++) { |
|
argv[index] = static_cast<napi_value>(args[index]); |
|
} |
|
|
|
return Call(recv, argc, argv); |
|
} |
|
|
|
inline MaybeOrValue<Value> Function::Call(napi_value recv, |
|
size_t argc, |
|
const napi_value* args) const { |
|
napi_value result; |
|
napi_status status = |
|
napi_call_function(_env, recv, _value, argc, args, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED( |
|
_env, status, Napi::Value(_env, result), Napi::Value); |
|
} |
|
|
|
inline MaybeOrValue<Value> Function::MakeCallback( |
|
napi_value recv, |
|
const std::initializer_list<napi_value>& args, |
|
napi_async_context context) const { |
|
return MakeCallback(recv, args.size(), args.begin(), context); |
|
} |
|
|
|
inline MaybeOrValue<Value> Function::MakeCallback( |
|
napi_value recv, |
|
const std::vector<napi_value>& args, |
|
napi_async_context context) const { |
|
return MakeCallback(recv, args.size(), args.data(), context); |
|
} |
|
|
|
inline MaybeOrValue<Value> Function::MakeCallback( |
|
napi_value recv, |
|
size_t argc, |
|
const napi_value* args, |
|
napi_async_context context) const { |
|
napi_value result; |
|
napi_status status = |
|
napi_make_callback(_env, context, recv, _value, argc, args, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED( |
|
_env, status, Napi::Value(_env, result), Napi::Value); |
|
} |
|
|
|
inline MaybeOrValue<Object> Function::New( |
|
const std::initializer_list<napi_value>& args) const { |
|
return New(args.size(), args.begin()); |
|
} |
|
|
|
inline MaybeOrValue<Object> Function::New( |
|
const std::vector<napi_value>& args) const { |
|
return New(args.size(), args.data()); |
|
} |
|
|
|
inline MaybeOrValue<Object> Function::New(size_t argc, |
|
const napi_value* args) const { |
|
napi_value result; |
|
napi_status status = napi_new_instance(_env, _value, argc, args, &result); |
|
NAPI_RETURN_OR_THROW_IF_FAILED( |
|
_env, status, Napi::Object(_env, result), Napi::Object); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Promise class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline Promise::Deferred Promise::Deferred::New(napi_env env) { |
|
return Promise::Deferred(env); |
|
} |
|
|
|
inline Promise::Deferred::Deferred(napi_env env) : _env(env) { |
|
napi_status status = napi_create_promise(_env, &_deferred, &_promise); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline Promise Promise::Deferred::Promise() const { |
|
return Napi::Promise(_env, _promise); |
|
} |
|
|
|
inline Napi::Env Promise::Deferred::Env() const { |
|
return Napi::Env(_env); |
|
} |
|
|
|
inline void Promise::Deferred::Resolve(napi_value value) const { |
|
napi_status status = napi_resolve_deferred(_env, _deferred, value); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline void Promise::Deferred::Reject(napi_value value) const { |
|
napi_status status = napi_reject_deferred(_env, _deferred, value); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline void Promise::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "Promise::CheckCast", "empty value"); |
|
|
|
bool result; |
|
napi_status status = napi_is_promise(env, value, &result); |
|
NAPI_CHECK(status == napi_ok, "Promise::CheckCast", "napi_is_promise failed"); |
|
NAPI_CHECK(result, "Promise::CheckCast", "value is not promise"); |
|
} |
|
|
|
inline Promise::Promise(napi_env env, napi_value value) : Object(env, value) {} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Buffer<T> class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
template <typename T> |
|
inline Buffer<T> Buffer<T>::New(napi_env env, size_t length) { |
|
napi_value value; |
|
void* data; |
|
napi_status status = |
|
napi_create_buffer(env, length * sizeof(T), &data, &value); |
|
NAPI_THROW_IF_FAILED(env, status, Buffer<T>()); |
|
return Buffer(env, value); |
|
} |
|
|
|
#ifndef NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
template <typename T> |
|
inline Buffer<T> Buffer<T>::New(napi_env env, T* data, size_t length) { |
|
napi_value value; |
|
napi_status status = napi_create_external_buffer( |
|
env, length * sizeof(T), data, nullptr, nullptr, &value); |
|
NAPI_THROW_IF_FAILED(env, status, Buffer<T>()); |
|
return Buffer(env, value); |
|
} |
|
|
|
template <typename T> |
|
template <typename Finalizer> |
|
inline Buffer<T> Buffer<T>::New(napi_env env, |
|
T* data, |
|
size_t length, |
|
Finalizer finalizeCallback) { |
|
napi_value value; |
|
details::FinalizeData<T, Finalizer>* finalizeData = |
|
new details::FinalizeData<T, Finalizer>( |
|
{std::move(finalizeCallback), nullptr}); |
|
napi_status status = |
|
napi_create_external_buffer(env, |
|
length * sizeof(T), |
|
data, |
|
details::FinalizeData<T, Finalizer>::Wrapper, |
|
finalizeData, |
|
&value); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED(env, status, Buffer()); |
|
} |
|
return Buffer(env, value); |
|
} |
|
|
|
template <typename T> |
|
template <typename Finalizer, typename Hint> |
|
inline Buffer<T> Buffer<T>::New(napi_env env, |
|
T* data, |
|
size_t length, |
|
Finalizer finalizeCallback, |
|
Hint* finalizeHint) { |
|
napi_value value; |
|
details::FinalizeData<T, Finalizer, Hint>* finalizeData = |
|
new details::FinalizeData<T, Finalizer, Hint>( |
|
{std::move(finalizeCallback), finalizeHint}); |
|
napi_status status = napi_create_external_buffer( |
|
env, |
|
length * sizeof(T), |
|
data, |
|
details::FinalizeData<T, Finalizer, Hint>::WrapperWithHint, |
|
finalizeData, |
|
&value); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED(env, status, Buffer()); |
|
} |
|
return Buffer(env, value); |
|
} |
|
#endif // NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
|
|
template <typename T> |
|
inline Buffer<T> Buffer<T>::NewOrCopy(napi_env env, T* data, size_t length) { |
|
#ifndef NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
napi_value value; |
|
napi_status status = napi_create_external_buffer( |
|
env, length * sizeof(T), data, nullptr, nullptr, &value); |
|
if (status == details::napi_no_external_buffers_allowed) { |
|
#endif // NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
// If we can't create an external buffer, we'll just copy the data. |
|
return Buffer<T>::Copy(env, data, length); |
|
#ifndef NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
} |
|
NAPI_THROW_IF_FAILED(env, status, Buffer<T>()); |
|
return Buffer(env, value); |
|
#endif // NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
} |
|
|
|
template <typename T> |
|
template <typename Finalizer> |
|
inline Buffer<T> Buffer<T>::NewOrCopy(napi_env env, |
|
T* data, |
|
size_t length, |
|
Finalizer finalizeCallback) { |
|
details::FinalizeData<T, Finalizer>* finalizeData = |
|
new details::FinalizeData<T, Finalizer>( |
|
{std::move(finalizeCallback), nullptr}); |
|
#ifndef NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
napi_value value; |
|
napi_status status = |
|
napi_create_external_buffer(env, |
|
length * sizeof(T), |
|
data, |
|
details::FinalizeData<T, Finalizer>::Wrapper, |
|
finalizeData, |
|
&value); |
|
if (status == details::napi_no_external_buffers_allowed) { |
|
#endif // NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
// If we can't create an external buffer, we'll just copy the data. |
|
Buffer<T> ret = Buffer<T>::Copy(env, data, length); |
|
details::FinalizeData<T, Finalizer>::Wrapper(env, data, finalizeData); |
|
return ret; |
|
#ifndef NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
} |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED(env, status, Buffer()); |
|
} |
|
return Buffer(env, value); |
|
#endif // NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
} |
|
|
|
template <typename T> |
|
template <typename Finalizer, typename Hint> |
|
inline Buffer<T> Buffer<T>::NewOrCopy(napi_env env, |
|
T* data, |
|
size_t length, |
|
Finalizer finalizeCallback, |
|
Hint* finalizeHint) { |
|
details::FinalizeData<T, Finalizer, Hint>* finalizeData = |
|
new details::FinalizeData<T, Finalizer, Hint>( |
|
{std::move(finalizeCallback), finalizeHint}); |
|
#ifndef NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
napi_value value; |
|
napi_status status = napi_create_external_buffer( |
|
env, |
|
length * sizeof(T), |
|
data, |
|
details::FinalizeData<T, Finalizer, Hint>::WrapperWithHint, |
|
finalizeData, |
|
&value); |
|
if (status == details::napi_no_external_buffers_allowed) { |
|
#endif |
|
// If we can't create an external buffer, we'll just copy the data. |
|
Buffer<T> ret = Buffer<T>::Copy(env, data, length); |
|
details::FinalizeData<T, Finalizer, Hint>::WrapperWithHint( |
|
env, data, finalizeData); |
|
return ret; |
|
#ifndef NODE_API_NO_EXTERNAL_BUFFERS_ALLOWED |
|
} |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED(env, status, Buffer()); |
|
} |
|
return Buffer(env, value); |
|
#endif |
|
} |
|
|
|
template <typename T> |
|
inline Buffer<T> Buffer<T>::Copy(napi_env env, const T* data, size_t length) { |
|
napi_value value; |
|
napi_status status = |
|
napi_create_buffer_copy(env, length * sizeof(T), data, nullptr, &value); |
|
NAPI_THROW_IF_FAILED(env, status, Buffer<T>()); |
|
return Buffer<T>(env, value); |
|
} |
|
|
|
template <typename T> |
|
inline void Buffer<T>::CheckCast(napi_env env, napi_value value) { |
|
NAPI_CHECK(value != nullptr, "Buffer::CheckCast", "empty value"); |
|
|
|
bool result; |
|
napi_status status = napi_is_buffer(env, value, &result); |
|
NAPI_CHECK(status == napi_ok, "Buffer::CheckCast", "napi_is_buffer failed"); |
|
NAPI_CHECK(result, "Buffer::CheckCast", "value is not buffer"); |
|
} |
|
|
|
template <typename T> |
|
inline Buffer<T>::Buffer() : Uint8Array() {} |
|
|
|
template <typename T> |
|
inline Buffer<T>::Buffer(napi_env env, napi_value value) |
|
: Uint8Array(env, value) {} |
|
|
|
template <typename T> |
|
inline size_t Buffer<T>::Length() const { |
|
return ByteLength() / sizeof(T); |
|
} |
|
|
|
template <typename T> |
|
inline T* Buffer<T>::Data() const { |
|
return reinterpret_cast<T*>(const_cast<uint8_t*>(Uint8Array::Data())); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Error class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline Error Error::New(napi_env env) { |
|
napi_status status; |
|
napi_value error = nullptr; |
|
bool is_exception_pending; |
|
napi_extended_error_info last_error_info_copy; |
|
|
|
{ |
|
// We must retrieve the last error info before doing anything else because |
|
// doing anything else will replace the last error info. |
|
const napi_extended_error_info* last_error_info; |
|
status = napi_get_last_error_info(env, &last_error_info); |
|
NAPI_FATAL_IF_FAILED(status, "Error::New", "napi_get_last_error_info"); |
|
|
|
// All fields of the `napi_extended_error_info` structure gets reset in |
|
// subsequent Node-API function calls on the same `env`. This includes a |
|
// call to `napi_is_exception_pending()`. So here it is necessary to make a |
|
// copy of the information as the `error_code` field is used later on. |
|
memcpy(&last_error_info_copy, |
|
last_error_info, |
|
sizeof(napi_extended_error_info)); |
|
} |
|
|
|
status = napi_is_exception_pending(env, &is_exception_pending); |
|
NAPI_FATAL_IF_FAILED(status, "Error::New", "napi_is_exception_pending"); |
|
|
|
// A pending exception takes precedence over any internal error status. |
|
if (is_exception_pending) { |
|
status = napi_get_and_clear_last_exception(env, &error); |
|
NAPI_FATAL_IF_FAILED( |
|
status, "Error::New", "napi_get_and_clear_last_exception"); |
|
} else { |
|
const char* error_message = last_error_info_copy.error_message != nullptr |
|
? last_error_info_copy.error_message |
|
: "Error in native callback"; |
|
|
|
napi_value message; |
|
status = napi_create_string_utf8( |
|
env, error_message, std::strlen(error_message), &message); |
|
NAPI_FATAL_IF_FAILED(status, "Error::New", "napi_create_string_utf8"); |
|
|
|
switch (last_error_info_copy.error_code) { |
|
case napi_object_expected: |
|
case napi_string_expected: |
|
case napi_boolean_expected: |
|
case napi_number_expected: |
|
status = napi_create_type_error(env, nullptr, message, &error); |
|
break; |
|
default: |
|
status = napi_create_error(env, nullptr, message, &error); |
|
break; |
|
} |
|
NAPI_FATAL_IF_FAILED(status, "Error::New", "napi_create_error"); |
|
} |
|
|
|
return Error(env, error); |
|
} |
|
|
|
inline Error Error::New(napi_env env, const char* message) { |
|
return Error::New<Error>( |
|
env, message, std::strlen(message), napi_create_error); |
|
} |
|
|
|
inline Error Error::New(napi_env env, const std::string& message) { |
|
return Error::New<Error>( |
|
env, message.c_str(), message.size(), napi_create_error); |
|
} |
|
|
|
inline NAPI_NO_RETURN void Error::Fatal(const char* location, |
|
const char* message) { |
|
napi_fatal_error(location, NAPI_AUTO_LENGTH, message, NAPI_AUTO_LENGTH); |
|
} |
|
|
|
inline Error::Error() : ObjectReference() {} |
|
|
|
inline Error::Error(napi_env env, napi_value value) |
|
: ObjectReference(env, nullptr) { |
|
if (value != nullptr) { |
|
// Attempting to create a reference on the error object. |
|
// If it's not a Object/Function/Symbol, this call will return an error |
|
// status. |
|
napi_status status = napi_create_reference(env, value, 1, &_ref); |
|
|
|
if (status != napi_ok) { |
|
napi_value wrappedErrorObj; |
|
|
|
// Create an error object |
|
status = napi_create_object(env, &wrappedErrorObj); |
|
NAPI_FATAL_IF_FAILED(status, "Error::Error", "napi_create_object"); |
|
|
|
// property flag that we attach to show the error object is wrapped |
|
napi_property_descriptor wrapObjFlag = { |
|
ERROR_WRAP_VALUE(), // Unique GUID identifier since Symbol isn't a |
|
// viable option |
|
nullptr, |
|
nullptr, |
|
nullptr, |
|
nullptr, |
|
Value::From(env, value), |
|
napi_enumerable, |
|
nullptr}; |
|
|
|
status = napi_define_properties(env, wrappedErrorObj, 1, &wrapObjFlag); |
|
#ifdef NODE_API_SWALLOW_UNTHROWABLE_EXCEPTIONS |
|
if (status == napi_pending_exception) { |
|
// Test if the pending exception was reported because the environment is |
|
// shutting down. We assume that a status of napi_pending_exception |
|
// coupled with the absence of an actual pending exception means that |
|
// the environment is shutting down. If so, we replace the |
|
// napi_pending_exception status with napi_ok. |
|
bool is_exception_pending = false; |
|
status = napi_is_exception_pending(env, &is_exception_pending); |
|
if (status == napi_ok && !is_exception_pending) { |
|
status = napi_ok; |
|
} else { |
|
status = napi_pending_exception; |
|
} |
|
} |
|
#endif // NODE_API_SWALLOW_UNTHROWABLE_EXCEPTIONS |
|
NAPI_FATAL_IF_FAILED(status, "Error::Error", "napi_define_properties"); |
|
|
|
// Create a reference on the newly wrapped object |
|
status = napi_create_reference(env, wrappedErrorObj, 1, &_ref); |
|
} |
|
|
|
// Avoid infinite recursion in the failure case. |
|
NAPI_FATAL_IF_FAILED(status, "Error::Error", "napi_create_reference"); |
|
} |
|
} |
|
|
|
inline Object Error::Value() const { |
|
if (_ref == nullptr) { |
|
return Object(_env, nullptr); |
|
} |
|
|
|
napi_value refValue; |
|
napi_status status = napi_get_reference_value(_env, _ref, &refValue); |
|
NAPI_THROW_IF_FAILED(_env, status, Object()); |
|
|
|
napi_valuetype type; |
|
status = napi_typeof(_env, refValue, &type); |
|
NAPI_THROW_IF_FAILED(_env, status, Object()); |
|
|
|
// If refValue isn't a symbol, then we proceed to whether the refValue has the |
|
// wrapped error flag |
|
if (type != napi_symbol) { |
|
// We are checking if the object is wrapped |
|
bool isWrappedObject = false; |
|
|
|
status = napi_has_property(_env, |
|
refValue, |
|
String::From(_env, ERROR_WRAP_VALUE()), |
|
&isWrappedObject); |
|
|
|
// Don't care about status |
|
if (isWrappedObject) { |
|
napi_value unwrappedValue; |
|
status = napi_get_property(_env, |
|
refValue, |
|
String::From(_env, ERROR_WRAP_VALUE()), |
|
&unwrappedValue); |
|
NAPI_THROW_IF_FAILED(_env, status, Object()); |
|
|
|
return Object(_env, unwrappedValue); |
|
} |
|
} |
|
|
|
return Object(_env, refValue); |
|
} |
|
|
|
inline Error::Error(Error&& other) : ObjectReference(std::move(other)) {} |
|
|
|
inline Error& Error::operator=(Error&& other) { |
|
static_cast<Reference<Object>*>(this)->operator=(std::move(other)); |
|
return *this; |
|
} |
|
|
|
inline Error::Error(const Error& other) : ObjectReference(other) {} |
|
|
|
inline Error& Error::operator=(const Error& other) { |
|
Reset(); |
|
|
|
_env = other.Env(); |
|
HandleScope scope(_env); |
|
|
|
napi_value value = other.Value(); |
|
if (value != nullptr) { |
|
napi_status status = napi_create_reference(_env, value, 1, &_ref); |
|
NAPI_THROW_IF_FAILED(_env, status, *this); |
|
} |
|
|
|
return *this; |
|
} |
|
|
|
inline const std::string& Error::Message() const NAPI_NOEXCEPT { |
|
if (_message.size() == 0 && _env != nullptr) { |
|
#ifdef NAPI_CPP_EXCEPTIONS |
|
try { |
|
_message = Get("message").As<String>(); |
|
} catch (...) { |
|
// Catch all errors here, to include e.g. a std::bad_alloc from |
|
// the std::string::operator=, because this method may not throw. |
|
} |
|
#else // NAPI_CPP_EXCEPTIONS |
|
#if defined(NODE_ADDON_API_ENABLE_MAYBE) |
|
Napi::Value message_val; |
|
if (Get("message").UnwrapTo(&message_val)) { |
|
_message = message_val.As<String>(); |
|
} |
|
#else |
|
_message = Get("message").As<String>(); |
|
#endif |
|
#endif // NAPI_CPP_EXCEPTIONS |
|
} |
|
return _message; |
|
} |
|
|
|
// we created an object on the &_ref |
|
inline void Error::ThrowAsJavaScriptException() const { |
|
HandleScope scope(_env); |
|
if (!IsEmpty()) { |
|
#ifdef NODE_API_SWALLOW_UNTHROWABLE_EXCEPTIONS |
|
bool pendingException = false; |
|
|
|
// check if there is already a pending exception. If so don't try to throw a |
|
// new one as that is not allowed/possible |
|
napi_status status = napi_is_exception_pending(_env, &pendingException); |
|
|
|
if ((status != napi_ok) || |
|
((status == napi_ok) && (pendingException == false))) { |
|
// We intentionally don't use `NAPI_THROW_*` macros here to ensure |
|
// that there is no possible recursion as `ThrowAsJavaScriptException` |
|
// is part of `NAPI_THROW_*` macro definition for noexcept. |
|
|
|
status = napi_throw(_env, Value()); |
|
|
|
if (status == napi_pending_exception) { |
|
// The environment must be terminating as we checked earlier and there |
|
// was no pending exception. In this case continuing will result |
|
// in a fatal error and there is nothing the author has done incorrectly |
|
// in their code that is worth flagging through a fatal error |
|
return; |
|
} |
|
} else { |
|
status = napi_pending_exception; |
|
} |
|
#else |
|
// We intentionally don't use `NAPI_THROW_*` macros here to ensure |
|
// that there is no possible recursion as `ThrowAsJavaScriptException` |
|
// is part of `NAPI_THROW_*` macro definition for noexcept. |
|
|
|
napi_status status = napi_throw(_env, Value()); |
|
#endif |
|
|
|
#ifdef NAPI_CPP_EXCEPTIONS |
|
if (status != napi_ok) { |
|
throw Error::New(_env); |
|
} |
|
#else // NAPI_CPP_EXCEPTIONS |
|
NAPI_FATAL_IF_FAILED( |
|
status, "Error::ThrowAsJavaScriptException", "napi_throw"); |
|
#endif // NAPI_CPP_EXCEPTIONS |
|
} |
|
} |
|
|
|
#ifdef NAPI_CPP_EXCEPTIONS |
|
|
|
inline const char* Error::what() const NAPI_NOEXCEPT { |
|
return Message().c_str(); |
|
} |
|
|
|
#endif // NAPI_CPP_EXCEPTIONS |
|
|
|
inline const char* Error::ERROR_WRAP_VALUE() NAPI_NOEXCEPT { |
|
return "4bda9e7e-4913-4dbc-95de-891cbf66598e-errorVal"; |
|
} |
|
|
|
template <typename TError> |
|
inline TError Error::New(napi_env env, |
|
const char* message, |
|
size_t length, |
|
create_error_fn create_error) { |
|
napi_value str; |
|
napi_status status = napi_create_string_utf8(env, message, length, &str); |
|
NAPI_THROW_IF_FAILED(env, status, TError()); |
|
|
|
napi_value error; |
|
status = create_error(env, nullptr, str, &error); |
|
NAPI_THROW_IF_FAILED(env, status, TError()); |
|
|
|
return TError(env, error); |
|
} |
|
|
|
inline TypeError TypeError::New(napi_env env, const char* message) { |
|
return Error::New<TypeError>( |
|
env, message, std::strlen(message), napi_create_type_error); |
|
} |
|
|
|
inline TypeError TypeError::New(napi_env env, const std::string& message) { |
|
return Error::New<TypeError>( |
|
env, message.c_str(), message.size(), napi_create_type_error); |
|
} |
|
|
|
inline TypeError::TypeError() : Error() {} |
|
|
|
inline TypeError::TypeError(napi_env env, napi_value value) |
|
: Error(env, value) {} |
|
|
|
inline RangeError RangeError::New(napi_env env, const char* message) { |
|
return Error::New<RangeError>( |
|
env, message, std::strlen(message), napi_create_range_error); |
|
} |
|
|
|
inline RangeError RangeError::New(napi_env env, const std::string& message) { |
|
return Error::New<RangeError>( |
|
env, message.c_str(), message.size(), napi_create_range_error); |
|
} |
|
|
|
inline RangeError::RangeError() : Error() {} |
|
|
|
inline RangeError::RangeError(napi_env env, napi_value value) |
|
: Error(env, value) {} |
|
|
|
#if NAPI_VERSION > 8 |
|
inline SyntaxError SyntaxError::New(napi_env env, const char* message) { |
|
return Error::New<SyntaxError>( |
|
env, message, std::strlen(message), node_api_create_syntax_error); |
|
} |
|
|
|
inline SyntaxError SyntaxError::New(napi_env env, const std::string& message) { |
|
return Error::New<SyntaxError>( |
|
env, message.c_str(), message.size(), node_api_create_syntax_error); |
|
} |
|
|
|
inline SyntaxError::SyntaxError() : Error() {} |
|
|
|
inline SyntaxError::SyntaxError(napi_env env, napi_value value) |
|
: Error(env, value) {} |
|
#endif // NAPI_VERSION > 8 |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Reference<T> class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
template <typename T> |
|
inline Reference<T> Reference<T>::New(const T& value, |
|
uint32_t initialRefcount) { |
|
napi_env env = value.Env(); |
|
napi_value val = value; |
|
|
|
if (val == nullptr) { |
|
return Reference<T>(env, nullptr); |
|
} |
|
|
|
napi_ref ref; |
|
napi_status status = napi_create_reference(env, value, initialRefcount, &ref); |
|
NAPI_THROW_IF_FAILED(env, status, Reference<T>()); |
|
|
|
return Reference<T>(env, ref); |
|
} |
|
|
|
template <typename T> |
|
inline Reference<T>::Reference() |
|
: _env(nullptr), _ref(nullptr), _suppressDestruct(false) {} |
|
|
|
template <typename T> |
|
inline Reference<T>::Reference(napi_env env, napi_ref ref) |
|
: _env(env), _ref(ref), _suppressDestruct(false) {} |
|
|
|
template <typename T> |
|
inline Reference<T>::~Reference() { |
|
if (_ref != nullptr) { |
|
if (!_suppressDestruct) { |
|
napi_delete_reference(_env, _ref); |
|
} |
|
|
|
_ref = nullptr; |
|
} |
|
} |
|
|
|
template <typename T> |
|
inline Reference<T>::Reference(Reference<T>&& other) |
|
: _env(other._env), |
|
_ref(other._ref), |
|
_suppressDestruct(other._suppressDestruct) { |
|
other._env = nullptr; |
|
other._ref = nullptr; |
|
other._suppressDestruct = false; |
|
} |
|
|
|
template <typename T> |
|
inline Reference<T>& Reference<T>::operator=(Reference<T>&& other) { |
|
Reset(); |
|
_env = other._env; |
|
_ref = other._ref; |
|
_suppressDestruct = other._suppressDestruct; |
|
other._env = nullptr; |
|
other._ref = nullptr; |
|
other._suppressDestruct = false; |
|
return *this; |
|
} |
|
|
|
template <typename T> |
|
inline Reference<T>::Reference(const Reference<T>& other) |
|
: _env(other._env), _ref(nullptr), _suppressDestruct(false) { |
|
HandleScope scope(_env); |
|
|
|
napi_value value = other.Value(); |
|
if (value != nullptr) { |
|
// Copying is a limited scenario (currently only used for Error object) and |
|
// always creates a strong reference to the given value even if the incoming |
|
// reference is weak. |
|
napi_status status = napi_create_reference(_env, value, 1, &_ref); |
|
NAPI_FATAL_IF_FAILED( |
|
status, "Reference<T>::Reference", "napi_create_reference"); |
|
} |
|
} |
|
|
|
template <typename T> |
|
inline Reference<T>::operator napi_ref() const { |
|
return _ref; |
|
} |
|
|
|
template <typename T> |
|
inline bool Reference<T>::operator==(const Reference<T>& other) const { |
|
HandleScope scope(_env); |
|
return this->Value().StrictEquals(other.Value()); |
|
} |
|
|
|
template <typename T> |
|
inline bool Reference<T>::operator!=(const Reference<T>& other) const { |
|
return !this->operator==(other); |
|
} |
|
|
|
template <typename T> |
|
inline Napi::Env Reference<T>::Env() const { |
|
return Napi::Env(_env); |
|
} |
|
|
|
template <typename T> |
|
inline bool Reference<T>::IsEmpty() const { |
|
return _ref == nullptr; |
|
} |
|
|
|
template <typename T> |
|
inline T Reference<T>::Value() const { |
|
if (_ref == nullptr) { |
|
return T(_env, nullptr); |
|
} |
|
|
|
napi_value value; |
|
napi_status status = napi_get_reference_value(_env, _ref, &value); |
|
NAPI_THROW_IF_FAILED(_env, status, T()); |
|
return T(_env, value); |
|
} |
|
|
|
template <typename T> |
|
inline uint32_t Reference<T>::Ref() const { |
|
uint32_t result; |
|
napi_status status = napi_reference_ref(_env, _ref, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return result; |
|
} |
|
|
|
template <typename T> |
|
inline uint32_t Reference<T>::Unref() const { |
|
uint32_t result; |
|
napi_status status = napi_reference_unref(_env, _ref, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, 0); |
|
return result; |
|
} |
|
|
|
template <typename T> |
|
inline void Reference<T>::Reset() { |
|
if (_ref != nullptr) { |
|
napi_status status = napi_delete_reference(_env, _ref); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
_ref = nullptr; |
|
} |
|
} |
|
|
|
template <typename T> |
|
inline void Reference<T>::Reset(const T& value, uint32_t refcount) { |
|
Reset(); |
|
_env = value.Env(); |
|
|
|
napi_value val = value; |
|
if (val != nullptr) { |
|
napi_status status = napi_create_reference(_env, value, refcount, &_ref); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
} |
|
|
|
template <typename T> |
|
inline void Reference<T>::SuppressDestruct() { |
|
_suppressDestruct = true; |
|
} |
|
|
|
template <typename T> |
|
inline Reference<T> Weak(T value) { |
|
return Reference<T>::New(value, 0); |
|
} |
|
|
|
inline ObjectReference Weak(Object value) { |
|
return Reference<Object>::New(value, 0); |
|
} |
|
|
|
inline FunctionReference Weak(Function value) { |
|
return Reference<Function>::New(value, 0); |
|
} |
|
|
|
template <typename T> |
|
inline Reference<T> Persistent(T value) { |
|
return Reference<T>::New(value, 1); |
|
} |
|
|
|
inline ObjectReference Persistent(Object value) { |
|
return Reference<Object>::New(value, 1); |
|
} |
|
|
|
inline FunctionReference Persistent(Function value) { |
|
return Reference<Function>::New(value, 1); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// ObjectReference class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline ObjectReference::ObjectReference() : Reference<Object>() {} |
|
|
|
inline ObjectReference::ObjectReference(napi_env env, napi_ref ref) |
|
: Reference<Object>(env, ref) {} |
|
|
|
inline ObjectReference::ObjectReference(Reference<Object>&& other) |
|
: Reference<Object>(std::move(other)) {} |
|
|
|
inline ObjectReference& ObjectReference::operator=(Reference<Object>&& other) { |
|
static_cast<Reference<Object>*>(this)->operator=(std::move(other)); |
|
return *this; |
|
} |
|
|
|
inline ObjectReference::ObjectReference(ObjectReference&& other) |
|
: Reference<Object>(std::move(other)) {} |
|
|
|
inline ObjectReference& ObjectReference::operator=(ObjectReference&& other) { |
|
static_cast<Reference<Object>*>(this)->operator=(std::move(other)); |
|
return *this; |
|
} |
|
|
|
inline ObjectReference::ObjectReference(const ObjectReference& other) |
|
: Reference<Object>(other) {} |
|
|
|
inline MaybeOrValue<Napi::Value> ObjectReference::Get( |
|
const char* utf8name) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Napi::Value> result = Value().Get(utf8name); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap())); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Value(); |
|
} |
|
return scope.Escape(result); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<Napi::Value> ObjectReference::Get( |
|
const std::string& utf8name) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Napi::Value> result = Value().Get(utf8name); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap())); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Value(); |
|
} |
|
return scope.Escape(result); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(const char* utf8name, |
|
napi_value value) const { |
|
HandleScope scope(_env); |
|
return Value().Set(utf8name, value); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(const char* utf8name, |
|
Napi::Value value) const { |
|
HandleScope scope(_env); |
|
return Value().Set(utf8name, value); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(const char* utf8name, |
|
const char* utf8value) const { |
|
HandleScope scope(_env); |
|
return Value().Set(utf8name, utf8value); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(const char* utf8name, |
|
bool boolValue) const { |
|
HandleScope scope(_env); |
|
return Value().Set(utf8name, boolValue); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(const char* utf8name, |
|
double numberValue) const { |
|
HandleScope scope(_env); |
|
return Value().Set(utf8name, numberValue); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(const std::string& utf8name, |
|
napi_value value) const { |
|
HandleScope scope(_env); |
|
return Value().Set(utf8name, value); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(const std::string& utf8name, |
|
Napi::Value value) const { |
|
HandleScope scope(_env); |
|
return Value().Set(utf8name, value); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(const std::string& utf8name, |
|
std::string& utf8value) const { |
|
HandleScope scope(_env); |
|
return Value().Set(utf8name, utf8value); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(const std::string& utf8name, |
|
bool boolValue) const { |
|
HandleScope scope(_env); |
|
return Value().Set(utf8name, boolValue); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(const std::string& utf8name, |
|
double numberValue) const { |
|
HandleScope scope(_env); |
|
return Value().Set(utf8name, numberValue); |
|
} |
|
|
|
inline MaybeOrValue<Napi::Value> ObjectReference::Get(uint32_t index) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Napi::Value> result = Value().Get(index); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap())); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Value(); |
|
} |
|
return scope.Escape(result); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(uint32_t index, |
|
napi_value value) const { |
|
HandleScope scope(_env); |
|
return Value().Set(index, value); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(uint32_t index, |
|
Napi::Value value) const { |
|
HandleScope scope(_env); |
|
return Value().Set(index, value); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(uint32_t index, |
|
const char* utf8value) const { |
|
HandleScope scope(_env); |
|
return Value().Set(index, utf8value); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set( |
|
uint32_t index, const std::string& utf8value) const { |
|
HandleScope scope(_env); |
|
return Value().Set(index, utf8value); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(uint32_t index, |
|
bool boolValue) const { |
|
HandleScope scope(_env); |
|
return Value().Set(index, boolValue); |
|
} |
|
|
|
inline MaybeOrValue<bool> ObjectReference::Set(uint32_t index, |
|
double numberValue) const { |
|
HandleScope scope(_env); |
|
return Value().Set(index, numberValue); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// FunctionReference class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline FunctionReference::FunctionReference() : Reference<Function>() {} |
|
|
|
inline FunctionReference::FunctionReference(napi_env env, napi_ref ref) |
|
: Reference<Function>(env, ref) {} |
|
|
|
inline FunctionReference::FunctionReference(Reference<Function>&& other) |
|
: Reference<Function>(std::move(other)) {} |
|
|
|
inline FunctionReference& FunctionReference::operator=( |
|
Reference<Function>&& other) { |
|
static_cast<Reference<Function>*>(this)->operator=(std::move(other)); |
|
return *this; |
|
} |
|
|
|
inline FunctionReference::FunctionReference(FunctionReference&& other) |
|
: Reference<Function>(std::move(other)) {} |
|
|
|
inline FunctionReference& FunctionReference::operator=( |
|
FunctionReference&& other) { |
|
static_cast<Reference<Function>*>(this)->operator=(std::move(other)); |
|
return *this; |
|
} |
|
|
|
inline MaybeOrValue<Napi::Value> FunctionReference::operator()( |
|
const std::initializer_list<napi_value>& args) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Napi::Value> result = Value()(args); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap())); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Value(); |
|
} |
|
return scope.Escape(result); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<Napi::Value> FunctionReference::Call( |
|
const std::initializer_list<napi_value>& args) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Napi::Value> result = Value().Call(args); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap())); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Value(); |
|
} |
|
return scope.Escape(result); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<Napi::Value> FunctionReference::Call( |
|
const std::vector<napi_value>& args) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Napi::Value> result = Value().Call(args); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap())); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Value(); |
|
} |
|
return scope.Escape(result); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<Napi::Value> FunctionReference::Call( |
|
napi_value recv, const std::initializer_list<napi_value>& args) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Napi::Value> result = Value().Call(recv, args); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap())); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Value(); |
|
} |
|
return scope.Escape(result); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<Napi::Value> FunctionReference::Call( |
|
napi_value recv, const std::vector<napi_value>& args) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Napi::Value> result = Value().Call(recv, args); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap())); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Value(); |
|
} |
|
return scope.Escape(result); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<Napi::Value> FunctionReference::Call( |
|
napi_value recv, size_t argc, const napi_value* args) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Napi::Value> result = Value().Call(recv, argc, args); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap())); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Value(); |
|
} |
|
return scope.Escape(result); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<Napi::Value> FunctionReference::MakeCallback( |
|
napi_value recv, |
|
const std::initializer_list<napi_value>& args, |
|
napi_async_context context) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Napi::Value> result = Value().MakeCallback(recv, args, context); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap())); |
|
} |
|
|
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Value(); |
|
} |
|
return scope.Escape(result); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<Napi::Value> FunctionReference::MakeCallback( |
|
napi_value recv, |
|
const std::vector<napi_value>& args, |
|
napi_async_context context) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Napi::Value> result = Value().MakeCallback(recv, args, context); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap())); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Value(); |
|
} |
|
return scope.Escape(result); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<Napi::Value> FunctionReference::MakeCallback( |
|
napi_value recv, |
|
size_t argc, |
|
const napi_value* args, |
|
napi_async_context context) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Napi::Value> result = |
|
Value().MakeCallback(recv, argc, args, context); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap())); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Value(); |
|
} |
|
return scope.Escape(result); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<Object> FunctionReference::New( |
|
const std::initializer_list<napi_value>& args) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Object> result = Value().New(args); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap()).As<Object>()); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Object(); |
|
} |
|
return scope.Escape(result).As<Object>(); |
|
#endif |
|
} |
|
|
|
inline MaybeOrValue<Object> FunctionReference::New( |
|
const std::vector<napi_value>& args) const { |
|
EscapableHandleScope scope(_env); |
|
MaybeOrValue<Object> result = Value().New(args); |
|
#ifdef NODE_ADDON_API_ENABLE_MAYBE |
|
if (result.IsJust()) { |
|
return Just(scope.Escape(result.Unwrap()).As<Object>()); |
|
} |
|
return result; |
|
#else |
|
if (scope.Env().IsExceptionPending()) { |
|
return Object(); |
|
} |
|
return scope.Escape(result).As<Object>(); |
|
#endif |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// CallbackInfo class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline CallbackInfo::CallbackInfo(napi_env env, napi_callback_info info) |
|
: _env(env), |
|
_info(info), |
|
_this(nullptr), |
|
_dynamicArgs(nullptr), |
|
_data(nullptr) { |
|
_argc = _staticArgCount; |
|
_argv = _staticArgs; |
|
napi_status status = |
|
napi_get_cb_info(env, info, &_argc, _argv, &_this, &_data); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
|
|
if (_argc > _staticArgCount) { |
|
// Use either a fixed-size array (on the stack) or a dynamically-allocated |
|
// array (on the heap) depending on the number of args. |
|
_dynamicArgs = new napi_value[_argc]; |
|
_argv = _dynamicArgs; |
|
|
|
status = napi_get_cb_info(env, info, &_argc, _argv, nullptr, nullptr); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
} |
|
|
|
inline CallbackInfo::~CallbackInfo() { |
|
if (_dynamicArgs != nullptr) { |
|
delete[] _dynamicArgs; |
|
} |
|
} |
|
|
|
inline CallbackInfo::operator napi_callback_info() const { |
|
return _info; |
|
} |
|
|
|
inline Value CallbackInfo::NewTarget() const { |
|
napi_value newTarget; |
|
napi_status status = napi_get_new_target(_env, _info, &newTarget); |
|
NAPI_THROW_IF_FAILED(_env, status, Value()); |
|
return Value(_env, newTarget); |
|
} |
|
|
|
inline bool CallbackInfo::IsConstructCall() const { |
|
return !NewTarget().IsEmpty(); |
|
} |
|
|
|
inline Napi::Env CallbackInfo::Env() const { |
|
return Napi::Env(_env); |
|
} |
|
|
|
inline size_t CallbackInfo::Length() const { |
|
return _argc; |
|
} |
|
|
|
inline const Value CallbackInfo::operator[](size_t index) const { |
|
return index < _argc ? Value(_env, _argv[index]) : Env().Undefined(); |
|
} |
|
|
|
inline Value CallbackInfo::This() const { |
|
if (_this == nullptr) { |
|
return Env().Undefined(); |
|
} |
|
return Object(_env, _this); |
|
} |
|
|
|
inline void* CallbackInfo::Data() const { |
|
return _data; |
|
} |
|
|
|
inline void CallbackInfo::SetData(void* data) { |
|
_data = data; |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// PropertyDescriptor class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
template <typename PropertyDescriptor::GetterCallback Getter> |
|
PropertyDescriptor PropertyDescriptor::Accessor( |
|
const char* utf8name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
|
|
desc.utf8name = utf8name; |
|
desc.getter = details::TemplatedCallback<Getter>; |
|
desc.attributes = attributes; |
|
desc.data = data; |
|
|
|
return desc; |
|
} |
|
|
|
template <typename PropertyDescriptor::GetterCallback Getter> |
|
PropertyDescriptor PropertyDescriptor::Accessor( |
|
const std::string& utf8name, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
return Accessor<Getter>(utf8name.c_str(), attributes, data); |
|
} |
|
|
|
template <typename PropertyDescriptor::GetterCallback Getter> |
|
PropertyDescriptor PropertyDescriptor::Accessor( |
|
Name name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
|
|
desc.name = name; |
|
desc.getter = details::TemplatedCallback<Getter>; |
|
desc.attributes = attributes; |
|
desc.data = data; |
|
|
|
return desc; |
|
} |
|
|
|
template <typename PropertyDescriptor::GetterCallback Getter, |
|
typename PropertyDescriptor::SetterCallback Setter> |
|
PropertyDescriptor PropertyDescriptor::Accessor( |
|
const char* utf8name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
|
|
desc.utf8name = utf8name; |
|
desc.getter = details::TemplatedCallback<Getter>; |
|
desc.setter = details::TemplatedVoidCallback<Setter>; |
|
desc.attributes = attributes; |
|
desc.data = data; |
|
|
|
return desc; |
|
} |
|
|
|
template <typename PropertyDescriptor::GetterCallback Getter, |
|
typename PropertyDescriptor::SetterCallback Setter> |
|
PropertyDescriptor PropertyDescriptor::Accessor( |
|
const std::string& utf8name, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
return Accessor<Getter, Setter>(utf8name.c_str(), attributes, data); |
|
} |
|
|
|
template <typename PropertyDescriptor::GetterCallback Getter, |
|
typename PropertyDescriptor::SetterCallback Setter> |
|
PropertyDescriptor PropertyDescriptor::Accessor( |
|
Name name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
|
|
desc.name = name; |
|
desc.getter = details::TemplatedCallback<Getter>; |
|
desc.setter = details::TemplatedVoidCallback<Setter>; |
|
desc.attributes = attributes; |
|
desc.data = data; |
|
|
|
return desc; |
|
} |
|
|
|
template <typename Getter> |
|
inline PropertyDescriptor PropertyDescriptor::Accessor( |
|
Napi::Env env, |
|
Napi::Object object, |
|
const char* utf8name, |
|
Getter getter, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
using CbData = details::CallbackData<Getter, Napi::Value>; |
|
auto callbackData = new CbData({getter, data}); |
|
|
|
napi_status status = AttachData(env, object, callbackData); |
|
if (status != napi_ok) { |
|
delete callbackData; |
|
NAPI_THROW_IF_FAILED(env, status, napi_property_descriptor()); |
|
} |
|
|
|
return PropertyDescriptor({utf8name, |
|
nullptr, |
|
nullptr, |
|
CbData::Wrapper, |
|
nullptr, |
|
nullptr, |
|
attributes, |
|
callbackData}); |
|
} |
|
|
|
template <typename Getter> |
|
inline PropertyDescriptor PropertyDescriptor::Accessor( |
|
Napi::Env env, |
|
Napi::Object object, |
|
const std::string& utf8name, |
|
Getter getter, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
return Accessor(env, object, utf8name.c_str(), getter, attributes, data); |
|
} |
|
|
|
template <typename Getter> |
|
inline PropertyDescriptor PropertyDescriptor::Accessor( |
|
Napi::Env env, |
|
Napi::Object object, |
|
Name name, |
|
Getter getter, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
using CbData = details::CallbackData<Getter, Napi::Value>; |
|
auto callbackData = new CbData({getter, data}); |
|
|
|
napi_status status = AttachData(env, object, callbackData); |
|
if (status != napi_ok) { |
|
delete callbackData; |
|
NAPI_THROW_IF_FAILED(env, status, napi_property_descriptor()); |
|
} |
|
|
|
return PropertyDescriptor({nullptr, |
|
name, |
|
nullptr, |
|
CbData::Wrapper, |
|
nullptr, |
|
nullptr, |
|
attributes, |
|
callbackData}); |
|
} |
|
|
|
template <typename Getter, typename Setter> |
|
inline PropertyDescriptor PropertyDescriptor::Accessor( |
|
Napi::Env env, |
|
Napi::Object object, |
|
const char* utf8name, |
|
Getter getter, |
|
Setter setter, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
using CbData = details::AccessorCallbackData<Getter, Setter>; |
|
auto callbackData = new CbData({getter, setter, data}); |
|
|
|
napi_status status = AttachData(env, object, callbackData); |
|
if (status != napi_ok) { |
|
delete callbackData; |
|
NAPI_THROW_IF_FAILED(env, status, napi_property_descriptor()); |
|
} |
|
|
|
return PropertyDescriptor({utf8name, |
|
nullptr, |
|
nullptr, |
|
CbData::GetterWrapper, |
|
CbData::SetterWrapper, |
|
nullptr, |
|
attributes, |
|
callbackData}); |
|
} |
|
|
|
template <typename Getter, typename Setter> |
|
inline PropertyDescriptor PropertyDescriptor::Accessor( |
|
Napi::Env env, |
|
Napi::Object object, |
|
const std::string& utf8name, |
|
Getter getter, |
|
Setter setter, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
return Accessor( |
|
env, object, utf8name.c_str(), getter, setter, attributes, data); |
|
} |
|
|
|
template <typename Getter, typename Setter> |
|
inline PropertyDescriptor PropertyDescriptor::Accessor( |
|
Napi::Env env, |
|
Napi::Object object, |
|
Name name, |
|
Getter getter, |
|
Setter setter, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
using CbData = details::AccessorCallbackData<Getter, Setter>; |
|
auto callbackData = new CbData({getter, setter, data}); |
|
|
|
napi_status status = AttachData(env, object, callbackData); |
|
if (status != napi_ok) { |
|
delete callbackData; |
|
NAPI_THROW_IF_FAILED(env, status, napi_property_descriptor()); |
|
} |
|
|
|
return PropertyDescriptor({nullptr, |
|
name, |
|
nullptr, |
|
CbData::GetterWrapper, |
|
CbData::SetterWrapper, |
|
nullptr, |
|
attributes, |
|
callbackData}); |
|
} |
|
|
|
template <typename Callable> |
|
inline PropertyDescriptor PropertyDescriptor::Function( |
|
Napi::Env env, |
|
Napi::Object /*object*/, |
|
const char* utf8name, |
|
Callable cb, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
return PropertyDescriptor({utf8name, |
|
nullptr, |
|
nullptr, |
|
nullptr, |
|
nullptr, |
|
Napi::Function::New(env, cb, utf8name, data), |
|
attributes, |
|
nullptr}); |
|
} |
|
|
|
template <typename Callable> |
|
inline PropertyDescriptor PropertyDescriptor::Function( |
|
Napi::Env env, |
|
Napi::Object object, |
|
const std::string& utf8name, |
|
Callable cb, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
return Function(env, object, utf8name.c_str(), cb, attributes, data); |
|
} |
|
|
|
template <typename Callable> |
|
inline PropertyDescriptor PropertyDescriptor::Function( |
|
Napi::Env env, |
|
Napi::Object /*object*/, |
|
Name name, |
|
Callable cb, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
return PropertyDescriptor({nullptr, |
|
name, |
|
nullptr, |
|
nullptr, |
|
nullptr, |
|
Napi::Function::New(env, cb, nullptr, data), |
|
attributes, |
|
nullptr}); |
|
} |
|
|
|
inline PropertyDescriptor PropertyDescriptor::Value( |
|
const char* utf8name, |
|
napi_value value, |
|
napi_property_attributes attributes) { |
|
return PropertyDescriptor({utf8name, |
|
nullptr, |
|
nullptr, |
|
nullptr, |
|
nullptr, |
|
value, |
|
attributes, |
|
nullptr}); |
|
} |
|
|
|
inline PropertyDescriptor PropertyDescriptor::Value( |
|
const std::string& utf8name, |
|
napi_value value, |
|
napi_property_attributes attributes) { |
|
return Value(utf8name.c_str(), value, attributes); |
|
} |
|
|
|
inline PropertyDescriptor PropertyDescriptor::Value( |
|
napi_value name, napi_value value, napi_property_attributes attributes) { |
|
return PropertyDescriptor( |
|
{nullptr, name, nullptr, nullptr, nullptr, value, attributes, nullptr}); |
|
} |
|
|
|
inline PropertyDescriptor PropertyDescriptor::Value( |
|
Name name, Napi::Value value, napi_property_attributes attributes) { |
|
napi_value nameValue = name; |
|
napi_value valueValue = value; |
|
return PropertyDescriptor::Value(nameValue, valueValue, attributes); |
|
} |
|
|
|
inline PropertyDescriptor::PropertyDescriptor(napi_property_descriptor desc) |
|
: _desc(desc) {} |
|
|
|
inline PropertyDescriptor::operator napi_property_descriptor&() { |
|
return _desc; |
|
} |
|
|
|
inline PropertyDescriptor::operator const napi_property_descriptor&() const { |
|
return _desc; |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// InstanceWrap<T> class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
template <typename T> |
|
inline void InstanceWrap<T>::AttachPropData( |
|
napi_env env, napi_value value, const napi_property_descriptor* prop) { |
|
napi_status status; |
|
if (!(prop->attributes & napi_static)) { |
|
if (prop->method == T::InstanceVoidMethodCallbackWrapper) { |
|
status = Napi::details::AttachData( |
|
env, value, static_cast<InstanceVoidMethodCallbackData*>(prop->data)); |
|
NAPI_THROW_IF_FAILED_VOID(env, status); |
|
} else if (prop->method == T::InstanceMethodCallbackWrapper) { |
|
status = Napi::details::AttachData( |
|
env, value, static_cast<InstanceMethodCallbackData*>(prop->data)); |
|
NAPI_THROW_IF_FAILED_VOID(env, status); |
|
} else if (prop->getter == T::InstanceGetterCallbackWrapper || |
|
prop->setter == T::InstanceSetterCallbackWrapper) { |
|
status = Napi::details::AttachData( |
|
env, value, static_cast<InstanceAccessorCallbackData*>(prop->data)); |
|
NAPI_THROW_IF_FAILED_VOID(env, status); |
|
} |
|
} |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceMethod( |
|
const char* utf8name, |
|
InstanceVoidMethodCallback method, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
InstanceVoidMethodCallbackData* callbackData = |
|
new InstanceVoidMethodCallbackData({method, data}); |
|
|
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.method = T::InstanceVoidMethodCallbackWrapper; |
|
desc.data = callbackData; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceMethod( |
|
const char* utf8name, |
|
InstanceMethodCallback method, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
InstanceMethodCallbackData* callbackData = |
|
new InstanceMethodCallbackData({method, data}); |
|
|
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.method = T::InstanceMethodCallbackWrapper; |
|
desc.data = callbackData; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceMethod( |
|
Symbol name, |
|
InstanceVoidMethodCallback method, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
InstanceVoidMethodCallbackData* callbackData = |
|
new InstanceVoidMethodCallbackData({method, data}); |
|
|
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.method = T::InstanceVoidMethodCallbackWrapper; |
|
desc.data = callbackData; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceMethod( |
|
Symbol name, |
|
InstanceMethodCallback method, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
InstanceMethodCallbackData* callbackData = |
|
new InstanceMethodCallbackData({method, data}); |
|
|
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.method = T::InstanceMethodCallbackWrapper; |
|
desc.data = callbackData; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
template <typename InstanceWrap<T>::InstanceVoidMethodCallback method> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceMethod( |
|
const char* utf8name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.method = details::TemplatedInstanceVoidCallback<T, method>; |
|
desc.data = data; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
template <typename InstanceWrap<T>::InstanceMethodCallback method> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceMethod( |
|
const char* utf8name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.method = details::TemplatedInstanceCallback<T, method>; |
|
desc.data = data; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
template <typename InstanceWrap<T>::InstanceVoidMethodCallback method> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceMethod( |
|
Symbol name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.method = details::TemplatedInstanceVoidCallback<T, method>; |
|
desc.data = data; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
template <typename InstanceWrap<T>::InstanceMethodCallback method> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceMethod( |
|
Symbol name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.method = details::TemplatedInstanceCallback<T, method>; |
|
desc.data = data; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceAccessor( |
|
const char* utf8name, |
|
InstanceGetterCallback getter, |
|
InstanceSetterCallback setter, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
InstanceAccessorCallbackData* callbackData = |
|
new InstanceAccessorCallbackData({getter, setter, data}); |
|
|
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.getter = getter != nullptr ? T::InstanceGetterCallbackWrapper : nullptr; |
|
desc.setter = setter != nullptr ? T::InstanceSetterCallbackWrapper : nullptr; |
|
desc.data = callbackData; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceAccessor( |
|
Symbol name, |
|
InstanceGetterCallback getter, |
|
InstanceSetterCallback setter, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
InstanceAccessorCallbackData* callbackData = |
|
new InstanceAccessorCallbackData({getter, setter, data}); |
|
|
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.getter = getter != nullptr ? T::InstanceGetterCallbackWrapper : nullptr; |
|
desc.setter = setter != nullptr ? T::InstanceSetterCallbackWrapper : nullptr; |
|
desc.data = callbackData; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
template <typename InstanceWrap<T>::InstanceGetterCallback getter, |
|
typename InstanceWrap<T>::InstanceSetterCallback setter> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceAccessor( |
|
const char* utf8name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.getter = details::TemplatedInstanceCallback<T, getter>; |
|
desc.setter = This::WrapSetter(This::SetterTag<setter>()); |
|
desc.data = data; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
template <typename InstanceWrap<T>::InstanceGetterCallback getter, |
|
typename InstanceWrap<T>::InstanceSetterCallback setter> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceAccessor( |
|
Symbol name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.getter = details::TemplatedInstanceCallback<T, getter>; |
|
desc.setter = This::WrapSetter(This::SetterTag<setter>()); |
|
desc.data = data; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceValue( |
|
const char* utf8name, |
|
Napi::Value value, |
|
napi_property_attributes attributes) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.value = value; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> InstanceWrap<T>::InstanceValue( |
|
Symbol name, Napi::Value value, napi_property_attributes attributes) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.value = value; |
|
desc.attributes = attributes; |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline napi_value InstanceWrap<T>::InstanceVoidMethodCallbackWrapper( |
|
napi_env env, napi_callback_info info) { |
|
return details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
InstanceVoidMethodCallbackData* callbackData = |
|
reinterpret_cast<InstanceVoidMethodCallbackData*>(callbackInfo.Data()); |
|
callbackInfo.SetData(callbackData->data); |
|
T* instance = T::Unwrap(callbackInfo.This().As<Object>()); |
|
auto cb = callbackData->callback; |
|
if (instance) (instance->*cb)(callbackInfo); |
|
return nullptr; |
|
}); |
|
} |
|
|
|
template <typename T> |
|
inline napi_value InstanceWrap<T>::InstanceMethodCallbackWrapper( |
|
napi_env env, napi_callback_info info) { |
|
return details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
InstanceMethodCallbackData* callbackData = |
|
reinterpret_cast<InstanceMethodCallbackData*>(callbackInfo.Data()); |
|
callbackInfo.SetData(callbackData->data); |
|
T* instance = T::Unwrap(callbackInfo.This().As<Object>()); |
|
auto cb = callbackData->callback; |
|
return instance ? (instance->*cb)(callbackInfo) : Napi::Value(); |
|
}); |
|
} |
|
|
|
template <typename T> |
|
inline napi_value InstanceWrap<T>::InstanceGetterCallbackWrapper( |
|
napi_env env, napi_callback_info info) { |
|
return details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
InstanceAccessorCallbackData* callbackData = |
|
reinterpret_cast<InstanceAccessorCallbackData*>(callbackInfo.Data()); |
|
callbackInfo.SetData(callbackData->data); |
|
T* instance = T::Unwrap(callbackInfo.This().As<Object>()); |
|
auto cb = callbackData->getterCallback; |
|
return instance ? (instance->*cb)(callbackInfo) : Napi::Value(); |
|
}); |
|
} |
|
|
|
template <typename T> |
|
inline napi_value InstanceWrap<T>::InstanceSetterCallbackWrapper( |
|
napi_env env, napi_callback_info info) { |
|
return details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
InstanceAccessorCallbackData* callbackData = |
|
reinterpret_cast<InstanceAccessorCallbackData*>(callbackInfo.Data()); |
|
callbackInfo.SetData(callbackData->data); |
|
T* instance = T::Unwrap(callbackInfo.This().As<Object>()); |
|
auto cb = callbackData->setterCallback; |
|
if (instance) (instance->*cb)(callbackInfo, callbackInfo[0]); |
|
return nullptr; |
|
}); |
|
} |
|
|
|
template <typename T> |
|
template <typename InstanceWrap<T>::InstanceSetterCallback method> |
|
inline napi_value InstanceWrap<T>::WrappedMethod( |
|
napi_env env, napi_callback_info info) NAPI_NOEXCEPT { |
|
return details::WrapCallback([&] { |
|
const CallbackInfo cbInfo(env, info); |
|
T* instance = T::Unwrap(cbInfo.This().As<Object>()); |
|
if (instance) (instance->*method)(cbInfo, cbInfo[0]); |
|
return nullptr; |
|
}); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// ObjectWrap<T> class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
template <typename T> |
|
inline ObjectWrap<T>::ObjectWrap(const Napi::CallbackInfo& callbackInfo) { |
|
napi_env env = callbackInfo.Env(); |
|
napi_value wrapper = callbackInfo.This(); |
|
napi_status status; |
|
napi_ref ref; |
|
T* instance = static_cast<T*>(this); |
|
status = napi_wrap(env, wrapper, instance, FinalizeCallback, nullptr, &ref); |
|
NAPI_THROW_IF_FAILED_VOID(env, status); |
|
|
|
Reference<Object>* instanceRef = instance; |
|
*instanceRef = Reference<Object>(env, ref); |
|
} |
|
|
|
template <typename T> |
|
inline ObjectWrap<T>::~ObjectWrap() { |
|
// If the JS object still exists at this point, remove the finalizer added |
|
// through `napi_wrap()`. |
|
if (!IsEmpty()) { |
|
Object object = Value(); |
|
// It is not valid to call `napi_remove_wrap()` with an empty `object`. |
|
// This happens e.g. during garbage collection. |
|
if (!object.IsEmpty() && _construction_failed) { |
|
napi_remove_wrap(Env(), object, nullptr); |
|
} |
|
} |
|
} |
|
|
|
template <typename T> |
|
inline T* ObjectWrap<T>::Unwrap(Object wrapper) { |
|
void* unwrapped; |
|
napi_status status = napi_unwrap(wrapper.Env(), wrapper, &unwrapped); |
|
NAPI_THROW_IF_FAILED(wrapper.Env(), status, nullptr); |
|
return static_cast<T*>(unwrapped); |
|
} |
|
|
|
template <typename T> |
|
inline Function ObjectWrap<T>::DefineClass( |
|
Napi::Env env, |
|
const char* utf8name, |
|
const size_t props_count, |
|
const napi_property_descriptor* descriptors, |
|
void* data) { |
|
napi_status status; |
|
std::vector<napi_property_descriptor> props(props_count); |
|
|
|
// We copy the descriptors to a local array because before defining the class |
|
// we must replace static method property descriptors with value property |
|
// descriptors such that the value is a function-valued `napi_value` created |
|
// with `CreateFunction()`. |
|
// |
|
// This replacement could be made for instance methods as well, but V8 aborts |
|
// if we do that, because it expects methods defined on the prototype template |
|
// to have `FunctionTemplate`s. |
|
for (size_t index = 0; index < props_count; index++) { |
|
props[index] = descriptors[index]; |
|
napi_property_descriptor* prop = &props[index]; |
|
if (prop->method == T::StaticMethodCallbackWrapper) { |
|
status = |
|
CreateFunction(env, |
|
utf8name, |
|
prop->method, |
|
static_cast<StaticMethodCallbackData*>(prop->data), |
|
&(prop->value)); |
|
NAPI_THROW_IF_FAILED(env, status, Function()); |
|
prop->method = nullptr; |
|
prop->data = nullptr; |
|
} else if (prop->method == T::StaticVoidMethodCallbackWrapper) { |
|
status = |
|
CreateFunction(env, |
|
utf8name, |
|
prop->method, |
|
static_cast<StaticVoidMethodCallbackData*>(prop->data), |
|
&(prop->value)); |
|
NAPI_THROW_IF_FAILED(env, status, Function()); |
|
prop->method = nullptr; |
|
prop->data = nullptr; |
|
} |
|
} |
|
|
|
napi_value value; |
|
status = napi_define_class(env, |
|
utf8name, |
|
NAPI_AUTO_LENGTH, |
|
T::ConstructorCallbackWrapper, |
|
data, |
|
props_count, |
|
props.data(), |
|
&value); |
|
NAPI_THROW_IF_FAILED(env, status, Function()); |
|
|
|
// After defining the class we iterate once more over the property descriptors |
|
// and attach the data associated with accessors and instance methods to the |
|
// newly created JavaScript class. |
|
for (size_t idx = 0; idx < props_count; idx++) { |
|
const napi_property_descriptor* prop = &props[idx]; |
|
|
|
if (prop->getter == T::StaticGetterCallbackWrapper || |
|
prop->setter == T::StaticSetterCallbackWrapper) { |
|
status = Napi::details::AttachData( |
|
env, value, static_cast<StaticAccessorCallbackData*>(prop->data)); |
|
NAPI_THROW_IF_FAILED(env, status, Function()); |
|
} else { |
|
// InstanceWrap<T>::AttachPropData is responsible for attaching the data |
|
// of instance methods and accessors. |
|
T::AttachPropData(env, value, prop); |
|
} |
|
} |
|
|
|
return Function(env, value); |
|
} |
|
|
|
template <typename T> |
|
inline Function ObjectWrap<T>::DefineClass( |
|
Napi::Env env, |
|
const char* utf8name, |
|
const std::initializer_list<ClassPropertyDescriptor<T>>& properties, |
|
void* data) { |
|
return DefineClass( |
|
env, |
|
utf8name, |
|
properties.size(), |
|
reinterpret_cast<const napi_property_descriptor*>(properties.begin()), |
|
data); |
|
} |
|
|
|
template <typename T> |
|
inline Function ObjectWrap<T>::DefineClass( |
|
Napi::Env env, |
|
const char* utf8name, |
|
const std::vector<ClassPropertyDescriptor<T>>& properties, |
|
void* data) { |
|
return DefineClass( |
|
env, |
|
utf8name, |
|
properties.size(), |
|
reinterpret_cast<const napi_property_descriptor*>(properties.data()), |
|
data); |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticMethod( |
|
const char* utf8name, |
|
StaticVoidMethodCallback method, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
StaticVoidMethodCallbackData* callbackData = |
|
new StaticVoidMethodCallbackData({method, data}); |
|
|
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.method = T::StaticVoidMethodCallbackWrapper; |
|
desc.data = callbackData; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticMethod( |
|
const char* utf8name, |
|
StaticMethodCallback method, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
StaticMethodCallbackData* callbackData = |
|
new StaticMethodCallbackData({method, data}); |
|
|
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.method = T::StaticMethodCallbackWrapper; |
|
desc.data = callbackData; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticMethod( |
|
Symbol name, |
|
StaticVoidMethodCallback method, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
StaticVoidMethodCallbackData* callbackData = |
|
new StaticVoidMethodCallbackData({method, data}); |
|
|
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.method = T::StaticVoidMethodCallbackWrapper; |
|
desc.data = callbackData; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticMethod( |
|
Symbol name, |
|
StaticMethodCallback method, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
StaticMethodCallbackData* callbackData = |
|
new StaticMethodCallbackData({method, data}); |
|
|
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.method = T::StaticMethodCallbackWrapper; |
|
desc.data = callbackData; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
template <typename ObjectWrap<T>::StaticVoidMethodCallback method> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticMethod( |
|
const char* utf8name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.method = details::TemplatedVoidCallback<method>; |
|
desc.data = data; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
template <typename ObjectWrap<T>::StaticVoidMethodCallback method> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticMethod( |
|
Symbol name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.method = details::TemplatedVoidCallback<method>; |
|
desc.data = data; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
template <typename ObjectWrap<T>::StaticMethodCallback method> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticMethod( |
|
const char* utf8name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.method = details::TemplatedCallback<method>; |
|
desc.data = data; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
template <typename ObjectWrap<T>::StaticMethodCallback method> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticMethod( |
|
Symbol name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.method = details::TemplatedCallback<method>; |
|
desc.data = data; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticAccessor( |
|
const char* utf8name, |
|
StaticGetterCallback getter, |
|
StaticSetterCallback setter, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
StaticAccessorCallbackData* callbackData = |
|
new StaticAccessorCallbackData({getter, setter, data}); |
|
|
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.getter = getter != nullptr ? T::StaticGetterCallbackWrapper : nullptr; |
|
desc.setter = setter != nullptr ? T::StaticSetterCallbackWrapper : nullptr; |
|
desc.data = callbackData; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticAccessor( |
|
Symbol name, |
|
StaticGetterCallback getter, |
|
StaticSetterCallback setter, |
|
napi_property_attributes attributes, |
|
void* data) { |
|
StaticAccessorCallbackData* callbackData = |
|
new StaticAccessorCallbackData({getter, setter, data}); |
|
|
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.getter = getter != nullptr ? T::StaticGetterCallbackWrapper : nullptr; |
|
desc.setter = setter != nullptr ? T::StaticSetterCallbackWrapper : nullptr; |
|
desc.data = callbackData; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
template <typename ObjectWrap<T>::StaticGetterCallback getter, |
|
typename ObjectWrap<T>::StaticSetterCallback setter> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticAccessor( |
|
const char* utf8name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.getter = details::TemplatedCallback<getter>; |
|
desc.setter = This::WrapStaticSetter(This::StaticSetterTag<setter>()); |
|
desc.data = data; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
template <typename ObjectWrap<T>::StaticGetterCallback getter, |
|
typename ObjectWrap<T>::StaticSetterCallback setter> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticAccessor( |
|
Symbol name, napi_property_attributes attributes, void* data) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.getter = details::TemplatedCallback<getter>; |
|
desc.setter = This::WrapStaticSetter(This::StaticSetterTag<setter>()); |
|
desc.data = data; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticValue( |
|
const char* utf8name, |
|
Napi::Value value, |
|
napi_property_attributes attributes) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.utf8name = utf8name; |
|
desc.value = value; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline ClassPropertyDescriptor<T> ObjectWrap<T>::StaticValue( |
|
Symbol name, Napi::Value value, napi_property_attributes attributes) { |
|
napi_property_descriptor desc = napi_property_descriptor(); |
|
desc.name = name; |
|
desc.value = value; |
|
desc.attributes = |
|
static_cast<napi_property_attributes>(attributes | napi_static); |
|
return desc; |
|
} |
|
|
|
template <typename T> |
|
inline Value ObjectWrap<T>::OnCalledAsFunction( |
|
const Napi::CallbackInfo& callbackInfo) { |
|
NAPI_THROW( |
|
TypeError::New(callbackInfo.Env(), |
|
"Class constructors cannot be invoked without 'new'"), |
|
Napi::Value()); |
|
} |
|
|
|
template <typename T> |
|
inline void ObjectWrap<T>::Finalize(Napi::Env /*env*/) {} |
|
|
|
template <typename T> |
|
inline napi_value ObjectWrap<T>::ConstructorCallbackWrapper( |
|
napi_env env, napi_callback_info info) { |
|
napi_value new_target; |
|
napi_status status = napi_get_new_target(env, info, &new_target); |
|
if (status != napi_ok) return nullptr; |
|
|
|
bool isConstructCall = (new_target != nullptr); |
|
if (!isConstructCall) { |
|
return details::WrapCallback( |
|
[&] { return T::OnCalledAsFunction(CallbackInfo(env, info)); }); |
|
} |
|
|
|
napi_value wrapper = details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
T* instance = new T(callbackInfo); |
|
#ifdef NAPI_CPP_EXCEPTIONS |
|
instance->_construction_failed = false; |
|
#else |
|
if (callbackInfo.Env().IsExceptionPending()) { |
|
// We need to clear the exception so that removing the wrap might work. |
|
Error e = callbackInfo.Env().GetAndClearPendingException(); |
|
delete instance; |
|
e.ThrowAsJavaScriptException(); |
|
} else { |
|
instance->_construction_failed = false; |
|
} |
|
#endif // NAPI_CPP_EXCEPTIONS |
|
return callbackInfo.This(); |
|
}); |
|
|
|
return wrapper; |
|
} |
|
|
|
template <typename T> |
|
inline napi_value ObjectWrap<T>::StaticVoidMethodCallbackWrapper( |
|
napi_env env, napi_callback_info info) { |
|
return details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
StaticVoidMethodCallbackData* callbackData = |
|
reinterpret_cast<StaticVoidMethodCallbackData*>(callbackInfo.Data()); |
|
callbackInfo.SetData(callbackData->data); |
|
callbackData->callback(callbackInfo); |
|
return nullptr; |
|
}); |
|
} |
|
|
|
template <typename T> |
|
inline napi_value ObjectWrap<T>::StaticMethodCallbackWrapper( |
|
napi_env env, napi_callback_info info) { |
|
return details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
StaticMethodCallbackData* callbackData = |
|
reinterpret_cast<StaticMethodCallbackData*>(callbackInfo.Data()); |
|
callbackInfo.SetData(callbackData->data); |
|
return callbackData->callback(callbackInfo); |
|
}); |
|
} |
|
|
|
template <typename T> |
|
inline napi_value ObjectWrap<T>::StaticGetterCallbackWrapper( |
|
napi_env env, napi_callback_info info) { |
|
return details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
StaticAccessorCallbackData* callbackData = |
|
reinterpret_cast<StaticAccessorCallbackData*>(callbackInfo.Data()); |
|
callbackInfo.SetData(callbackData->data); |
|
return callbackData->getterCallback(callbackInfo); |
|
}); |
|
} |
|
|
|
template <typename T> |
|
inline napi_value ObjectWrap<T>::StaticSetterCallbackWrapper( |
|
napi_env env, napi_callback_info info) { |
|
return details::WrapCallback([&] { |
|
CallbackInfo callbackInfo(env, info); |
|
StaticAccessorCallbackData* callbackData = |
|
reinterpret_cast<StaticAccessorCallbackData*>(callbackInfo.Data()); |
|
callbackInfo.SetData(callbackData->data); |
|
callbackData->setterCallback(callbackInfo, callbackInfo[0]); |
|
return nullptr; |
|
}); |
|
} |
|
|
|
template <typename T> |
|
inline void ObjectWrap<T>::FinalizeCallback(napi_env env, |
|
void* data, |
|
void* /*hint*/) { |
|
HandleScope scope(env); |
|
T* instance = static_cast<T*>(data); |
|
instance->Finalize(Napi::Env(env)); |
|
delete instance; |
|
} |
|
|
|
template <typename T> |
|
template <typename ObjectWrap<T>::StaticSetterCallback method> |
|
inline napi_value ObjectWrap<T>::WrappedMethod( |
|
napi_env env, napi_callback_info info) NAPI_NOEXCEPT { |
|
return details::WrapCallback([&] { |
|
const CallbackInfo cbInfo(env, info); |
|
method(cbInfo, cbInfo[0]); |
|
return nullptr; |
|
}); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// HandleScope class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline HandleScope::HandleScope(napi_env env, napi_handle_scope scope) |
|
: _env(env), _scope(scope) {} |
|
|
|
inline HandleScope::HandleScope(Napi::Env env) : _env(env) { |
|
napi_status status = napi_open_handle_scope(_env, &_scope); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline HandleScope::~HandleScope() { |
|
napi_status status = napi_close_handle_scope(_env, _scope); |
|
NAPI_FATAL_IF_FAILED( |
|
status, "HandleScope::~HandleScope", "napi_close_handle_scope"); |
|
} |
|
|
|
inline HandleScope::operator napi_handle_scope() const { |
|
return _scope; |
|
} |
|
|
|
inline Napi::Env HandleScope::Env() const { |
|
return Napi::Env(_env); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// EscapableHandleScope class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline EscapableHandleScope::EscapableHandleScope( |
|
napi_env env, napi_escapable_handle_scope scope) |
|
: _env(env), _scope(scope) {} |
|
|
|
inline EscapableHandleScope::EscapableHandleScope(Napi::Env env) : _env(env) { |
|
napi_status status = napi_open_escapable_handle_scope(_env, &_scope); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline EscapableHandleScope::~EscapableHandleScope() { |
|
napi_status status = napi_close_escapable_handle_scope(_env, _scope); |
|
NAPI_FATAL_IF_FAILED(status, |
|
"EscapableHandleScope::~EscapableHandleScope", |
|
"napi_close_escapable_handle_scope"); |
|
} |
|
|
|
inline EscapableHandleScope::operator napi_escapable_handle_scope() const { |
|
return _scope; |
|
} |
|
|
|
inline Napi::Env EscapableHandleScope::Env() const { |
|
return Napi::Env(_env); |
|
} |
|
|
|
inline Value EscapableHandleScope::Escape(napi_value escapee) { |
|
napi_value result; |
|
napi_status status = napi_escape_handle(_env, _scope, escapee, &result); |
|
NAPI_THROW_IF_FAILED(_env, status, Value()); |
|
return Value(_env, result); |
|
} |
|
|
|
#if (NAPI_VERSION > 2) |
|
//////////////////////////////////////////////////////////////////////////////// |
|
// CallbackScope class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline CallbackScope::CallbackScope(napi_env env, napi_callback_scope scope) |
|
: _env(env), _scope(scope) {} |
|
|
|
inline CallbackScope::CallbackScope(napi_env env, napi_async_context context) |
|
: _env(env) { |
|
napi_status status = |
|
napi_open_callback_scope(_env, Object::New(env), context, &_scope); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline CallbackScope::~CallbackScope() { |
|
napi_status status = napi_close_callback_scope(_env, _scope); |
|
NAPI_FATAL_IF_FAILED( |
|
status, "CallbackScope::~CallbackScope", "napi_close_callback_scope"); |
|
} |
|
|
|
inline CallbackScope::operator napi_callback_scope() const { |
|
return _scope; |
|
} |
|
|
|
inline Napi::Env CallbackScope::Env() const { |
|
return Napi::Env(_env); |
|
} |
|
#endif |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// AsyncContext class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline AsyncContext::AsyncContext(napi_env env, const char* resource_name) |
|
: AsyncContext(env, resource_name, Object::New(env)) {} |
|
|
|
inline AsyncContext::AsyncContext(napi_env env, |
|
const char* resource_name, |
|
const Object& resource) |
|
: _env(env), _context(nullptr) { |
|
napi_value resource_id; |
|
napi_status status = napi_create_string_utf8( |
|
_env, resource_name, NAPI_AUTO_LENGTH, &resource_id); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
|
|
status = napi_async_init(_env, resource, resource_id, &_context); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline AsyncContext::~AsyncContext() { |
|
if (_context != nullptr) { |
|
napi_async_destroy(_env, _context); |
|
_context = nullptr; |
|
} |
|
} |
|
|
|
inline AsyncContext::AsyncContext(AsyncContext&& other) { |
|
_env = other._env; |
|
other._env = nullptr; |
|
_context = other._context; |
|
other._context = nullptr; |
|
} |
|
|
|
inline AsyncContext& AsyncContext::operator=(AsyncContext&& other) { |
|
_env = other._env; |
|
other._env = nullptr; |
|
_context = other._context; |
|
other._context = nullptr; |
|
return *this; |
|
} |
|
|
|
inline AsyncContext::operator napi_async_context() const { |
|
return _context; |
|
} |
|
|
|
inline Napi::Env AsyncContext::Env() const { |
|
return Napi::Env(_env); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// AsyncWorker class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
#if NAPI_HAS_THREADS |
|
|
|
inline AsyncWorker::AsyncWorker(const Function& callback) |
|
: AsyncWorker(callback, "generic") {} |
|
|
|
inline AsyncWorker::AsyncWorker(const Function& callback, |
|
const char* resource_name) |
|
: AsyncWorker(callback, resource_name, Object::New(callback.Env())) {} |
|
|
|
inline AsyncWorker::AsyncWorker(const Function& callback, |
|
const char* resource_name, |
|
const Object& resource) |
|
: AsyncWorker( |
|
Object::New(callback.Env()), callback, resource_name, resource) {} |
|
|
|
inline AsyncWorker::AsyncWorker(const Object& receiver, |
|
const Function& callback) |
|
: AsyncWorker(receiver, callback, "generic") {} |
|
|
|
inline AsyncWorker::AsyncWorker(const Object& receiver, |
|
const Function& callback, |
|
const char* resource_name) |
|
: AsyncWorker( |
|
receiver, callback, resource_name, Object::New(callback.Env())) {} |
|
|
|
inline AsyncWorker::AsyncWorker(const Object& receiver, |
|
const Function& callback, |
|
const char* resource_name, |
|
const Object& resource) |
|
: _env(callback.Env()), |
|
_receiver(Napi::Persistent(receiver)), |
|
_callback(Napi::Persistent(callback)), |
|
_suppress_destruct(false) { |
|
napi_value resource_id; |
|
napi_status status = napi_create_string_latin1( |
|
_env, resource_name, NAPI_AUTO_LENGTH, &resource_id); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
|
|
status = napi_create_async_work(_env, |
|
resource, |
|
resource_id, |
|
OnAsyncWorkExecute, |
|
OnAsyncWorkComplete, |
|
this, |
|
&_work); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline AsyncWorker::AsyncWorker(Napi::Env env) : AsyncWorker(env, "generic") {} |
|
|
|
inline AsyncWorker::AsyncWorker(Napi::Env env, const char* resource_name) |
|
: AsyncWorker(env, resource_name, Object::New(env)) {} |
|
|
|
inline AsyncWorker::AsyncWorker(Napi::Env env, |
|
const char* resource_name, |
|
const Object& resource) |
|
: _env(env), _receiver(), _callback(), _suppress_destruct(false) { |
|
napi_value resource_id; |
|
napi_status status = napi_create_string_latin1( |
|
_env, resource_name, NAPI_AUTO_LENGTH, &resource_id); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
|
|
status = napi_create_async_work(_env, |
|
resource, |
|
resource_id, |
|
OnAsyncWorkExecute, |
|
OnAsyncWorkComplete, |
|
this, |
|
&_work); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline AsyncWorker::~AsyncWorker() { |
|
if (_work != nullptr) { |
|
napi_delete_async_work(_env, _work); |
|
_work = nullptr; |
|
} |
|
} |
|
|
|
inline void AsyncWorker::Destroy() { |
|
delete this; |
|
} |
|
|
|
inline AsyncWorker::operator napi_async_work() const { |
|
return _work; |
|
} |
|
|
|
inline Napi::Env AsyncWorker::Env() const { |
|
return Napi::Env(_env); |
|
} |
|
|
|
inline void AsyncWorker::Queue() { |
|
napi_status status = napi_queue_async_work(_env, _work); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline void AsyncWorker::Cancel() { |
|
napi_status status = napi_cancel_async_work(_env, _work); |
|
NAPI_THROW_IF_FAILED_VOID(_env, status); |
|
} |
|
|
|
inline ObjectReference& AsyncWorker::Receiver() { |
|
return _receiver; |
|
} |
|
|
|
inline FunctionReference& AsyncWorker::Callback() { |
|
return _callback; |
|
} |
|
|
|
inline void AsyncWorker::SuppressDestruct() { |
|
_suppress_destruct = true; |
|
} |
|
|
|
inline void AsyncWorker::OnOK() { |
|
if (!_callback.IsEmpty()) { |
|
_callback.Call(_receiver.Value(), GetResult(_callback.Env())); |
|
} |
|
} |
|
|
|
inline void AsyncWorker::OnError(const Error& e) { |
|
if (!_callback.IsEmpty()) { |
|
_callback.Call(_receiver.Value(), |
|
std::initializer_list<napi_value>{e.Value()}); |
|
} |
|
} |
|
|
|
inline void AsyncWorker::SetError(const std::string& error) { |
|
_error = error; |
|
} |
|
|
|
inline std::vector<napi_value> AsyncWorker::GetResult(Napi::Env /*env*/) { |
|
return {}; |
|
} |
|
// The OnAsyncWorkExecute method receives an napi_env argument. However, do NOT |
|
// use it within this method, as it does not run on the JavaScript thread and |
|
// must not run any method that would cause JavaScript to run. In practice, |
|
// this means that almost any use of napi_env will be incorrect. |
|
inline void AsyncWorker::OnAsyncWorkExecute(napi_env env, void* asyncworker) { |
|
AsyncWorker* self = static_cast<AsyncWorker*>(asyncworker); |
|
self->OnExecute(env); |
|
} |
|
// The OnExecute method receives an napi_env argument. However, do NOT |
|
// use it within this method, as it does not run on the JavaScript thread and |
|
// must not run any method that would cause JavaScript to run. In practice, |
|
// this means that almost any use of napi_env will be incorrect. |
|
inline void AsyncWorker::OnExecute(Napi::Env /*DO_NOT_USE*/) { |
|
#ifdef NAPI_CPP_EXCEPTIONS |
|
try { |
|
Execute(); |
|
} catch (const std::exception& e) { |
|
SetError(e.what()); |
|
} |
|
#else // NAPI_CPP_EXCEPTIONS |
|
Execute(); |
|
#endif // NAPI_CPP_EXCEPTIONS |
|
} |
|
|
|
inline void AsyncWorker::OnAsyncWorkComplete(napi_env env, |
|
napi_status status, |
|
void* asyncworker) { |
|
AsyncWorker* self = static_cast<AsyncWorker*>(asyncworker); |
|
self->OnWorkComplete(env, status); |
|
} |
|
inline void AsyncWorker::OnWorkComplete(Napi::Env /*env*/, napi_status status) { |
|
if (status != napi_cancelled) { |
|
HandleScope scope(_env); |
|
details::WrapCallback([&] { |
|
if (_error.size() == 0) { |
|
OnOK(); |
|
} else { |
|
OnError(Error::New(_env, _error)); |
|
} |
|
return nullptr; |
|
}); |
|
} |
|
if (!_suppress_destruct) { |
|
Destroy(); |
|
} |
|
} |
|
|
|
#endif // NAPI_HAS_THREADS |
|
|
|
#if (NAPI_VERSION > 3 && NAPI_HAS_THREADS) |
|
//////////////////////////////////////////////////////////////////////////////// |
|
// TypedThreadSafeFunction<ContextType,DataType,CallJs> class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
// Starting with NAPI 5, the JavaScript function `func` parameter of |
|
// `napi_create_threadsafe_function` is optional. |
|
#if NAPI_VERSION > 4 |
|
// static, with Callback [missing] Resource [missing] Finalizer [missing] |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
template <typename ResourceString> |
|
inline TypedThreadSafeFunction<ContextType, DataType, CallJs> |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::New( |
|
napi_env env, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context) { |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs> tsfn; |
|
|
|
napi_status status = |
|
napi_create_threadsafe_function(env, |
|
nullptr, |
|
nullptr, |
|
String::From(env, resourceName), |
|
maxQueueSize, |
|
initialThreadCount, |
|
nullptr, |
|
nullptr, |
|
context, |
|
CallJsInternal, |
|
&tsfn._tsfn); |
|
if (status != napi_ok) { |
|
NAPI_THROW_IF_FAILED( |
|
env, status, TypedThreadSafeFunction<ContextType, DataType, CallJs>()); |
|
} |
|
|
|
return tsfn; |
|
} |
|
|
|
// static, with Callback [missing] Resource [passed] Finalizer [missing] |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
template <typename ResourceString> |
|
inline TypedThreadSafeFunction<ContextType, DataType, CallJs> |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::New( |
|
napi_env env, |
|
const Object& resource, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context) { |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs> tsfn; |
|
|
|
napi_status status = |
|
napi_create_threadsafe_function(env, |
|
nullptr, |
|
resource, |
|
String::From(env, resourceName), |
|
maxQueueSize, |
|
initialThreadCount, |
|
nullptr, |
|
nullptr, |
|
context, |
|
CallJsInternal, |
|
&tsfn._tsfn); |
|
if (status != napi_ok) { |
|
NAPI_THROW_IF_FAILED( |
|
env, status, TypedThreadSafeFunction<ContextType, DataType, CallJs>()); |
|
} |
|
|
|
return tsfn; |
|
} |
|
|
|
// static, with Callback [missing] Resource [missing] Finalizer [passed] |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
template <typename ResourceString, |
|
typename Finalizer, |
|
typename FinalizerDataType> |
|
inline TypedThreadSafeFunction<ContextType, DataType, CallJs> |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::New( |
|
napi_env env, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context, |
|
Finalizer finalizeCallback, |
|
FinalizerDataType* data) { |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs> tsfn; |
|
|
|
auto* finalizeData = new details:: |
|
ThreadSafeFinalize<ContextType, Finalizer, FinalizerDataType>( |
|
{data, finalizeCallback}); |
|
napi_status status = napi_create_threadsafe_function( |
|
env, |
|
nullptr, |
|
nullptr, |
|
String::From(env, resourceName), |
|
maxQueueSize, |
|
initialThreadCount, |
|
finalizeData, |
|
details::ThreadSafeFinalize<ContextType, Finalizer, FinalizerDataType>:: |
|
FinalizeFinalizeWrapperWithDataAndContext, |
|
context, |
|
CallJsInternal, |
|
&tsfn._tsfn); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED( |
|
env, status, TypedThreadSafeFunction<ContextType, DataType, CallJs>()); |
|
} |
|
|
|
return tsfn; |
|
} |
|
|
|
// static, with Callback [missing] Resource [passed] Finalizer [passed] |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
template <typename ResourceString, |
|
typename Finalizer, |
|
typename FinalizerDataType> |
|
inline TypedThreadSafeFunction<ContextType, DataType, CallJs> |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::New( |
|
napi_env env, |
|
const Object& resource, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context, |
|
Finalizer finalizeCallback, |
|
FinalizerDataType* data) { |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs> tsfn; |
|
|
|
auto* finalizeData = new details:: |
|
ThreadSafeFinalize<ContextType, Finalizer, FinalizerDataType>( |
|
{data, finalizeCallback}); |
|
napi_status status = napi_create_threadsafe_function( |
|
env, |
|
nullptr, |
|
resource, |
|
String::From(env, resourceName), |
|
maxQueueSize, |
|
initialThreadCount, |
|
finalizeData, |
|
details::ThreadSafeFinalize<ContextType, Finalizer, FinalizerDataType>:: |
|
FinalizeFinalizeWrapperWithDataAndContext, |
|
context, |
|
CallJsInternal, |
|
&tsfn._tsfn); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED( |
|
env, status, TypedThreadSafeFunction<ContextType, DataType, CallJs>()); |
|
} |
|
|
|
return tsfn; |
|
} |
|
#endif |
|
|
|
// static, with Callback [passed] Resource [missing] Finalizer [missing] |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
template <typename ResourceString> |
|
inline TypedThreadSafeFunction<ContextType, DataType, CallJs> |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::New( |
|
napi_env env, |
|
const Function& callback, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context) { |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs> tsfn; |
|
|
|
napi_status status = |
|
napi_create_threadsafe_function(env, |
|
callback, |
|
nullptr, |
|
String::From(env, resourceName), |
|
maxQueueSize, |
|
initialThreadCount, |
|
nullptr, |
|
nullptr, |
|
context, |
|
CallJsInternal, |
|
&tsfn._tsfn); |
|
if (status != napi_ok) { |
|
NAPI_THROW_IF_FAILED( |
|
env, status, TypedThreadSafeFunction<ContextType, DataType, CallJs>()); |
|
} |
|
|
|
return tsfn; |
|
} |
|
|
|
// static, with Callback [passed] Resource [passed] Finalizer [missing] |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
template <typename ResourceString> |
|
inline TypedThreadSafeFunction<ContextType, DataType, CallJs> |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::New( |
|
napi_env env, |
|
const Function& callback, |
|
const Object& resource, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context) { |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs> tsfn; |
|
|
|
napi_status status = |
|
napi_create_threadsafe_function(env, |
|
callback, |
|
resource, |
|
String::From(env, resourceName), |
|
maxQueueSize, |
|
initialThreadCount, |
|
nullptr, |
|
nullptr, |
|
context, |
|
CallJsInternal, |
|
&tsfn._tsfn); |
|
if (status != napi_ok) { |
|
NAPI_THROW_IF_FAILED( |
|
env, status, TypedThreadSafeFunction<ContextType, DataType, CallJs>()); |
|
} |
|
|
|
return tsfn; |
|
} |
|
|
|
// static, with Callback [passed] Resource [missing] Finalizer [passed] |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
template <typename ResourceString, |
|
typename Finalizer, |
|
typename FinalizerDataType> |
|
inline TypedThreadSafeFunction<ContextType, DataType, CallJs> |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::New( |
|
napi_env env, |
|
const Function& callback, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context, |
|
Finalizer finalizeCallback, |
|
FinalizerDataType* data) { |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs> tsfn; |
|
|
|
auto* finalizeData = new details:: |
|
ThreadSafeFinalize<ContextType, Finalizer, FinalizerDataType>( |
|
{data, finalizeCallback}); |
|
napi_status status = napi_create_threadsafe_function( |
|
env, |
|
callback, |
|
nullptr, |
|
String::From(env, resourceName), |
|
maxQueueSize, |
|
initialThreadCount, |
|
finalizeData, |
|
details::ThreadSafeFinalize<ContextType, Finalizer, FinalizerDataType>:: |
|
FinalizeFinalizeWrapperWithDataAndContext, |
|
context, |
|
CallJsInternal, |
|
&tsfn._tsfn); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED( |
|
env, status, TypedThreadSafeFunction<ContextType, DataType, CallJs>()); |
|
} |
|
|
|
return tsfn; |
|
} |
|
|
|
// static, with: Callback [passed] Resource [passed] Finalizer [passed] |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
template <typename CallbackType, |
|
typename ResourceString, |
|
typename Finalizer, |
|
typename FinalizerDataType> |
|
inline TypedThreadSafeFunction<ContextType, DataType, CallJs> |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::New( |
|
napi_env env, |
|
CallbackType callback, |
|
const Object& resource, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context, |
|
Finalizer finalizeCallback, |
|
FinalizerDataType* data) { |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs> tsfn; |
|
|
|
auto* finalizeData = new details:: |
|
ThreadSafeFinalize<ContextType, Finalizer, FinalizerDataType>( |
|
{data, finalizeCallback}); |
|
napi_status status = napi_create_threadsafe_function( |
|
env, |
|
details::DefaultCallbackWrapper< |
|
CallbackType, |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>>(env, |
|
callback), |
|
resource, |
|
String::From(env, resourceName), |
|
maxQueueSize, |
|
initialThreadCount, |
|
finalizeData, |
|
details::ThreadSafeFinalize<ContextType, Finalizer, FinalizerDataType>:: |
|
FinalizeFinalizeWrapperWithDataAndContext, |
|
context, |
|
CallJsInternal, |
|
&tsfn._tsfn); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED( |
|
env, status, TypedThreadSafeFunction<ContextType, DataType, CallJs>()); |
|
} |
|
|
|
return tsfn; |
|
} |
|
|
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
inline TypedThreadSafeFunction<ContextType, DataType, CallJs>:: |
|
TypedThreadSafeFunction() |
|
: _tsfn() {} |
|
|
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
inline TypedThreadSafeFunction<ContextType, DataType, CallJs>:: |
|
TypedThreadSafeFunction(napi_threadsafe_function tsfn) |
|
: _tsfn(tsfn) {} |
|
|
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
inline TypedThreadSafeFunction<ContextType, DataType, CallJs>:: |
|
operator napi_threadsafe_function() const { |
|
return _tsfn; |
|
} |
|
|
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
inline napi_status |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::BlockingCall( |
|
DataType* data) const { |
|
return napi_call_threadsafe_function(_tsfn, data, napi_tsfn_blocking); |
|
} |
|
|
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
inline napi_status |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::NonBlockingCall( |
|
DataType* data) const { |
|
return napi_call_threadsafe_function(_tsfn, data, napi_tsfn_nonblocking); |
|
} |
|
|
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
inline void TypedThreadSafeFunction<ContextType, DataType, CallJs>::Ref( |
|
napi_env env) const { |
|
if (_tsfn != nullptr) { |
|
napi_status status = napi_ref_threadsafe_function(env, _tsfn); |
|
NAPI_THROW_IF_FAILED_VOID(env, status); |
|
} |
|
} |
|
|
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
inline void TypedThreadSafeFunction<ContextType, DataType, CallJs>::Unref( |
|
napi_env env) const { |
|
if (_tsfn != nullptr) { |
|
napi_status status = napi_unref_threadsafe_function(env, _tsfn); |
|
NAPI_THROW_IF_FAILED_VOID(env, status); |
|
} |
|
} |
|
|
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
inline napi_status |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::Acquire() const { |
|
return napi_acquire_threadsafe_function(_tsfn); |
|
} |
|
|
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
inline napi_status |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::Release() const { |
|
return napi_release_threadsafe_function(_tsfn, napi_tsfn_release); |
|
} |
|
|
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
inline napi_status |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::Abort() const { |
|
return napi_release_threadsafe_function(_tsfn, napi_tsfn_abort); |
|
} |
|
|
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
inline ContextType* |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::GetContext() const { |
|
void* context; |
|
napi_status status = napi_get_threadsafe_function_context(_tsfn, &context); |
|
NAPI_FATAL_IF_FAILED(status, |
|
"TypedThreadSafeFunction::GetContext", |
|
"napi_get_threadsafe_function_context"); |
|
return static_cast<ContextType*>(context); |
|
} |
|
|
|
// static |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
void TypedThreadSafeFunction<ContextType, DataType, CallJs>::CallJsInternal( |
|
napi_env env, napi_value jsCallback, void* context, void* data) { |
|
details::CallJsWrapper<ContextType, DataType, decltype(CallJs), CallJs>( |
|
env, jsCallback, context, data); |
|
} |
|
|
|
#if NAPI_VERSION == 4 |
|
// static |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
Napi::Function |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::EmptyFunctionFactory( |
|
Napi::Env env) { |
|
return Napi::Function::New(env, [](const CallbackInfo& cb) {}); |
|
} |
|
|
|
// static |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
Napi::Function |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::FunctionOrEmpty( |
|
Napi::Env env, Napi::Function& callback) { |
|
if (callback.IsEmpty()) { |
|
return EmptyFunctionFactory(env); |
|
} |
|
return callback; |
|
} |
|
|
|
#else |
|
// static |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
std::nullptr_t |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::EmptyFunctionFactory( |
|
Napi::Env /*env*/) { |
|
return nullptr; |
|
} |
|
|
|
// static |
|
template <typename ContextType, |
|
typename DataType, |
|
void (*CallJs)(Napi::Env, Napi::Function, ContextType*, DataType*)> |
|
Napi::Function |
|
TypedThreadSafeFunction<ContextType, DataType, CallJs>::FunctionOrEmpty( |
|
Napi::Env /*env*/, Napi::Function& callback) { |
|
return callback; |
|
} |
|
|
|
#endif |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// ThreadSafeFunction class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
// static |
|
template <typename ResourceString> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount) { |
|
return New( |
|
env, callback, Object(), resourceName, maxQueueSize, initialThreadCount); |
|
} |
|
|
|
// static |
|
template <typename ResourceString, typename ContextType> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context) { |
|
return New(env, |
|
callback, |
|
Object(), |
|
resourceName, |
|
maxQueueSize, |
|
initialThreadCount, |
|
context); |
|
} |
|
|
|
// static |
|
template <typename ResourceString, typename Finalizer> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
Finalizer finalizeCallback) { |
|
return New(env, |
|
callback, |
|
Object(), |
|
resourceName, |
|
maxQueueSize, |
|
initialThreadCount, |
|
finalizeCallback); |
|
} |
|
|
|
// static |
|
template <typename ResourceString, |
|
typename Finalizer, |
|
typename FinalizerDataType> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
Finalizer finalizeCallback, |
|
FinalizerDataType* data) { |
|
return New(env, |
|
callback, |
|
Object(), |
|
resourceName, |
|
maxQueueSize, |
|
initialThreadCount, |
|
finalizeCallback, |
|
data); |
|
} |
|
|
|
// static |
|
template <typename ResourceString, typename ContextType, typename Finalizer> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context, |
|
Finalizer finalizeCallback) { |
|
return New(env, |
|
callback, |
|
Object(), |
|
resourceName, |
|
maxQueueSize, |
|
initialThreadCount, |
|
context, |
|
finalizeCallback); |
|
} |
|
|
|
// static |
|
template <typename ResourceString, |
|
typename ContextType, |
|
typename Finalizer, |
|
typename FinalizerDataType> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context, |
|
Finalizer finalizeCallback, |
|
FinalizerDataType* data) { |
|
return New(env, |
|
callback, |
|
Object(), |
|
resourceName, |
|
maxQueueSize, |
|
initialThreadCount, |
|
context, |
|
finalizeCallback, |
|
data); |
|
} |
|
|
|
// static |
|
template <typename ResourceString> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
const Object& resource, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount) { |
|
return New(env, |
|
callback, |
|
resource, |
|
resourceName, |
|
maxQueueSize, |
|
initialThreadCount, |
|
static_cast<void*>(nullptr) /* context */); |
|
} |
|
|
|
// static |
|
template <typename ResourceString, typename ContextType> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
const Object& resource, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context) { |
|
return New(env, |
|
callback, |
|
resource, |
|
resourceName, |
|
maxQueueSize, |
|
initialThreadCount, |
|
context, |
|
[](Env, ContextType*) {} /* empty finalizer */); |
|
} |
|
|
|
// static |
|
template <typename ResourceString, typename Finalizer> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
const Object& resource, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
Finalizer finalizeCallback) { |
|
return New(env, |
|
callback, |
|
resource, |
|
resourceName, |
|
maxQueueSize, |
|
initialThreadCount, |
|
static_cast<void*>(nullptr) /* context */, |
|
finalizeCallback, |
|
static_cast<void*>(nullptr) /* data */, |
|
details::ThreadSafeFinalize<void, Finalizer>::Wrapper); |
|
} |
|
|
|
// static |
|
template <typename ResourceString, |
|
typename Finalizer, |
|
typename FinalizerDataType> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
const Object& resource, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
Finalizer finalizeCallback, |
|
FinalizerDataType* data) { |
|
return New(env, |
|
callback, |
|
resource, |
|
resourceName, |
|
maxQueueSize, |
|
initialThreadCount, |
|
static_cast<void*>(nullptr) /* context */, |
|
finalizeCallback, |
|
data, |
|
details::ThreadSafeFinalize<void, Finalizer, FinalizerDataType>:: |
|
FinalizeWrapperWithData); |
|
} |
|
|
|
// static |
|
template <typename ResourceString, typename ContextType, typename Finalizer> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
const Object& resource, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context, |
|
Finalizer finalizeCallback) { |
|
return New( |
|
env, |
|
callback, |
|
resource, |
|
resourceName, |
|
maxQueueSize, |
|
initialThreadCount, |
|
context, |
|
finalizeCallback, |
|
static_cast<void*>(nullptr) /* data */, |
|
details::ThreadSafeFinalize<ContextType, |
|
Finalizer>::FinalizeWrapperWithContext); |
|
} |
|
|
|
// static |
|
template <typename ResourceString, |
|
typename ContextType, |
|
typename Finalizer, |
|
typename FinalizerDataType> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
const Object& resource, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context, |
|
Finalizer finalizeCallback, |
|
FinalizerDataType* data) { |
|
return New( |
|
env, |
|
callback, |
|
resource, |
|
resourceName, |
|
maxQueueSize, |
|
initialThreadCount, |
|
context, |
|
finalizeCallback, |
|
data, |
|
details::ThreadSafeFinalize<ContextType, Finalizer, FinalizerDataType>:: |
|
FinalizeFinalizeWrapperWithDataAndContext); |
|
} |
|
|
|
inline ThreadSafeFunction::ThreadSafeFunction() : _tsfn() {} |
|
|
|
inline ThreadSafeFunction::ThreadSafeFunction(napi_threadsafe_function tsfn) |
|
: _tsfn(tsfn) {} |
|
|
|
inline ThreadSafeFunction::operator napi_threadsafe_function() const { |
|
return _tsfn; |
|
} |
|
|
|
inline napi_status ThreadSafeFunction::BlockingCall() const { |
|
return CallInternal(nullptr, napi_tsfn_blocking); |
|
} |
|
|
|
template <> |
|
inline napi_status ThreadSafeFunction::BlockingCall(void* data) const { |
|
return napi_call_threadsafe_function(_tsfn, data, napi_tsfn_blocking); |
|
} |
|
|
|
template <typename Callback> |
|
inline napi_status ThreadSafeFunction::BlockingCall(Callback callback) const { |
|
return CallInternal(new CallbackWrapper(callback), napi_tsfn_blocking); |
|
} |
|
|
|
template <typename DataType, typename Callback> |
|
inline napi_status ThreadSafeFunction::BlockingCall(DataType* data, |
|
Callback callback) const { |
|
auto wrapper = [data, callback](Env env, Function jsCallback) { |
|
callback(env, jsCallback, data); |
|
}; |
|
return CallInternal(new CallbackWrapper(wrapper), napi_tsfn_blocking); |
|
} |
|
|
|
inline napi_status ThreadSafeFunction::NonBlockingCall() const { |
|
return CallInternal(nullptr, napi_tsfn_nonblocking); |
|
} |
|
|
|
template <> |
|
inline napi_status ThreadSafeFunction::NonBlockingCall(void* data) const { |
|
return napi_call_threadsafe_function(_tsfn, data, napi_tsfn_nonblocking); |
|
} |
|
|
|
template <typename Callback> |
|
inline napi_status ThreadSafeFunction::NonBlockingCall( |
|
Callback callback) const { |
|
return CallInternal(new CallbackWrapper(callback), napi_tsfn_nonblocking); |
|
} |
|
|
|
template <typename DataType, typename Callback> |
|
inline napi_status ThreadSafeFunction::NonBlockingCall( |
|
DataType* data, Callback callback) const { |
|
auto wrapper = [data, callback](Env env, Function jsCallback) { |
|
callback(env, jsCallback, data); |
|
}; |
|
return CallInternal(new CallbackWrapper(wrapper), napi_tsfn_nonblocking); |
|
} |
|
|
|
inline void ThreadSafeFunction::Ref(napi_env env) const { |
|
if (_tsfn != nullptr) { |
|
napi_status status = napi_ref_threadsafe_function(env, _tsfn); |
|
NAPI_THROW_IF_FAILED_VOID(env, status); |
|
} |
|
} |
|
|
|
inline void ThreadSafeFunction::Unref(napi_env env) const { |
|
if (_tsfn != nullptr) { |
|
napi_status status = napi_unref_threadsafe_function(env, _tsfn); |
|
NAPI_THROW_IF_FAILED_VOID(env, status); |
|
} |
|
} |
|
|
|
inline napi_status ThreadSafeFunction::Acquire() const { |
|
return napi_acquire_threadsafe_function(_tsfn); |
|
} |
|
|
|
inline napi_status ThreadSafeFunction::Release() const { |
|
return napi_release_threadsafe_function(_tsfn, napi_tsfn_release); |
|
} |
|
|
|
inline napi_status ThreadSafeFunction::Abort() const { |
|
return napi_release_threadsafe_function(_tsfn, napi_tsfn_abort); |
|
} |
|
|
|
inline ThreadSafeFunction::ConvertibleContext ThreadSafeFunction::GetContext() |
|
const { |
|
void* context; |
|
napi_status status = napi_get_threadsafe_function_context(_tsfn, &context); |
|
NAPI_FATAL_IF_FAILED(status, |
|
"ThreadSafeFunction::GetContext", |
|
"napi_get_threadsafe_function_context"); |
|
return ConvertibleContext({context}); |
|
} |
|
|
|
// static |
|
template <typename ResourceString, |
|
typename ContextType, |
|
typename Finalizer, |
|
typename FinalizerDataType> |
|
inline ThreadSafeFunction ThreadSafeFunction::New(napi_env env, |
|
const Function& callback, |
|
const Object& resource, |
|
ResourceString resourceName, |
|
size_t maxQueueSize, |
|
size_t initialThreadCount, |
|
ContextType* context, |
|
Finalizer finalizeCallback, |
|
FinalizerDataType* data, |
|
napi_finalize wrapper) { |
|
static_assert(details::can_make_string<ResourceString>::value || |
|
std::is_convertible<ResourceString, napi_value>::value, |
|
"Resource name should be convertible to the string type"); |
|
|
|
ThreadSafeFunction tsfn; |
|
auto* finalizeData = new details:: |
|
ThreadSafeFinalize<ContextType, Finalizer, FinalizerDataType>( |
|
{data, finalizeCallback}); |
|
napi_status status = |
|
napi_create_threadsafe_function(env, |
|
callback, |
|
resource, |
|
Value::From(env, resourceName), |
|
maxQueueSize, |
|
initialThreadCount, |
|
finalizeData, |
|
wrapper, |
|
context, |
|
CallJS, |
|
&tsfn._tsfn); |
|
if (status != napi_ok) { |
|
delete finalizeData; |
|
NAPI_THROW_IF_FAILED(env, status, ThreadSafeFunction()); |
|
} |
|
|
|
return tsfn; |
|
} |
|
|
|
inline napi_status ThreadSafeFunction::CallInternal( |
|
CallbackWrapper* callbackWrapper, |
|
napi_threadsafe_function_call_mode mode) const { |
|
napi_status status = |
|
napi_call_threadsafe_function(_tsfn, callbackWrapper, mode); |
|
if (status != napi_ok && callbackWrapper != nullptr) { |
|
delete callbackWrapper; |
|
} |
|
|
|
return status; |
|
} |
|
|
|
// static |
|
inline void ThreadSafeFunction::CallJS(napi_env env, |
|
napi_value jsCallback, |
|
void* /* context */, |
|
void* data) { |
|
if (env == nullptr && jsCallback == nullptr) { |
|
return; |
|
} |
|
|
|
details::WrapVoidCallback([&]() { |
|
if (data != nullptr) { |
|
auto* callbackWrapper = static_cast<CallbackWrapper*>(data); |
|
(*callbackWrapper)(env, Function(env, jsCallback)); |
|
delete callbackWrapper; |
|
} else if (jsCallback != nullptr) { |
|
Function(env, jsCallback).Call({}); |
|
} |
|
}); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Async Progress Worker Base class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
template <typename DataType> |
|
inline AsyncProgressWorkerBase<DataType>::AsyncProgressWorkerBase( |
|
const Object& receiver, |
|
const Function& callback, |
|
const char* resource_name, |
|
const Object& resource, |
|
size_t queue_size) |
|
: AsyncWorker(receiver, callback, resource_name, resource) { |
|
// Fill all possible arguments to work around ambiguous |
|
// ThreadSafeFunction::New signatures. |
|
_tsfn = ThreadSafeFunction::New(callback.Env(), |
|
callback, |
|
resource, |
|
resource_name, |
|
queue_size, |
|
/** initialThreadCount */ 1, |
|
/** context */ this, |
|
OnThreadSafeFunctionFinalize, |
|
/** finalizeData */ this); |
|
} |
|
|
|
#if NAPI_VERSION > 4 |
|
template <typename DataType> |
|
inline AsyncProgressWorkerBase<DataType>::AsyncProgressWorkerBase( |
|
Napi::Env env, |
|
const char* resource_name, |
|
const Object& resource, |
|
size_t queue_size) |
|
: AsyncWorker(env, resource_name, resource) { |
|
// TODO: Once the changes to make the callback optional for threadsafe |
|
// functions are available on all versions we can remove the dummy Function |
|
// here. |
|
Function callback; |
|
// Fill all possible arguments to work around ambiguous |
|
// ThreadSafeFunction::New signatures. |
|
_tsfn = ThreadSafeFunction::New(env, |
|
callback, |
|
resource, |
|
resource_name, |
|
queue_size, |
|
/** initialThreadCount */ 1, |
|
/** context */ this, |
|
OnThreadSafeFunctionFinalize, |
|
/** finalizeData */ this); |
|
} |
|
#endif |
|
|
|
template <typename DataType> |
|
inline AsyncProgressWorkerBase<DataType>::~AsyncProgressWorkerBase() { |
|
// Abort pending tsfn call. |
|
// Don't send progress events after we've already completed. |
|
// It's ok to call ThreadSafeFunction::Abort and ThreadSafeFunction::Release |
|
// duplicated. |
|
_tsfn.Abort(); |
|
} |
|
|
|
template <typename DataType> |
|
inline void AsyncProgressWorkerBase<DataType>::OnAsyncWorkProgress( |
|
Napi::Env /* env */, Napi::Function /* jsCallback */, void* data) { |
|
ThreadSafeData* tsd = static_cast<ThreadSafeData*>(data); |
|
tsd->asyncprogressworker()->OnWorkProgress(tsd->data()); |
|
delete tsd; |
|
} |
|
|
|
template <typename DataType> |
|
inline napi_status AsyncProgressWorkerBase<DataType>::NonBlockingCall( |
|
DataType* data) { |
|
auto tsd = new AsyncProgressWorkerBase::ThreadSafeData(this, data); |
|
auto ret = _tsfn.NonBlockingCall(tsd, OnAsyncWorkProgress); |
|
if (ret != napi_ok) { |
|
delete tsd; |
|
} |
|
return ret; |
|
} |
|
|
|
template <typename DataType> |
|
inline void AsyncProgressWorkerBase<DataType>::OnWorkComplete( |
|
Napi::Env /* env */, napi_status status) { |
|
_work_completed = true; |
|
_complete_status = status; |
|
_tsfn.Release(); |
|
} |
|
|
|
template <typename DataType> |
|
inline void AsyncProgressWorkerBase<DataType>::OnThreadSafeFunctionFinalize( |
|
Napi::Env env, void* /* data */, AsyncProgressWorkerBase* context) { |
|
if (context->_work_completed) { |
|
context->AsyncWorker::OnWorkComplete(env, context->_complete_status); |
|
} |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Async Progress Worker class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
template <class T> |
|
inline AsyncProgressWorker<T>::AsyncProgressWorker(const Function& callback) |
|
: AsyncProgressWorker(callback, "generic") {} |
|
|
|
template <class T> |
|
inline AsyncProgressWorker<T>::AsyncProgressWorker(const Function& callback, |
|
const char* resource_name) |
|
: AsyncProgressWorker( |
|
callback, resource_name, Object::New(callback.Env())) {} |
|
|
|
template <class T> |
|
inline AsyncProgressWorker<T>::AsyncProgressWorker(const Function& callback, |
|
const char* resource_name, |
|
const Object& resource) |
|
: AsyncProgressWorker( |
|
Object::New(callback.Env()), callback, resource_name, resource) {} |
|
|
|
template <class T> |
|
inline AsyncProgressWorker<T>::AsyncProgressWorker(const Object& receiver, |
|
const Function& callback) |
|
: AsyncProgressWorker(receiver, callback, "generic") {} |
|
|
|
template <class T> |
|
inline AsyncProgressWorker<T>::AsyncProgressWorker(const Object& receiver, |
|
const Function& callback, |
|
const char* resource_name) |
|
: AsyncProgressWorker( |
|
receiver, callback, resource_name, Object::New(callback.Env())) {} |
|
|
|
template <class T> |
|
inline AsyncProgressWorker<T>::AsyncProgressWorker(const Object& receiver, |
|
const Function& callback, |
|
const char* resource_name, |
|
const Object& resource) |
|
: AsyncProgressWorkerBase(receiver, callback, resource_name, resource), |
|
_asyncdata(nullptr), |
|
_asyncsize(0), |
|
_signaled(false) {} |
|
|
|
#if NAPI_VERSION > 4 |
|
template <class T> |
|
inline AsyncProgressWorker<T>::AsyncProgressWorker(Napi::Env env) |
|
: AsyncProgressWorker(env, "generic") {} |
|
|
|
template <class T> |
|
inline AsyncProgressWorker<T>::AsyncProgressWorker(Napi::Env env, |
|
const char* resource_name) |
|
: AsyncProgressWorker(env, resource_name, Object::New(env)) {} |
|
|
|
template <class T> |
|
inline AsyncProgressWorker<T>::AsyncProgressWorker(Napi::Env env, |
|
const char* resource_name, |
|
const Object& resource) |
|
: AsyncProgressWorkerBase(env, resource_name, resource), |
|
_asyncdata(nullptr), |
|
_asyncsize(0) {} |
|
#endif |
|
|
|
template <class T> |
|
inline AsyncProgressWorker<T>::~AsyncProgressWorker() { |
|
{ |
|
std::lock_guard<std::mutex> lock(this->_mutex); |
|
_asyncdata = nullptr; |
|
_asyncsize = 0; |
|
} |
|
} |
|
|
|
template <class T> |
|
inline void AsyncProgressWorker<T>::Execute() { |
|
ExecutionProgress progress(this); |
|
Execute(progress); |
|
} |
|
|
|
template <class T> |
|
inline void AsyncProgressWorker<T>::OnWorkProgress(void*) { |
|
T* data; |
|
size_t size; |
|
bool signaled; |
|
{ |
|
std::lock_guard<std::mutex> lock(this->_mutex); |
|
data = this->_asyncdata; |
|
size = this->_asyncsize; |
|
signaled = this->_signaled; |
|
this->_asyncdata = nullptr; |
|
this->_asyncsize = 0; |
|
this->_signaled = false; |
|
} |
|
|
|
/** |
|
* The callback of ThreadSafeFunction is not been invoked immediately on the |
|
* callback of uv_async_t (uv io poll), rather the callback of TSFN is |
|
* invoked on the right next uv idle callback. There are chances that during |
|
* the deferring the signal of uv_async_t is been sent again, i.e. potential |
|
* not coalesced two calls of the TSFN callback. |
|
*/ |
|
if (data == nullptr && !signaled) { |
|
return; |
|
} |
|
|
|
this->OnProgress(data, size); |
|
delete[] data; |
|
} |
|
|
|
template <class T> |
|
inline void AsyncProgressWorker<T>::SendProgress_(const T* data, size_t count) { |
|
T* new_data = new T[count]; |
|
std::copy(data, data + count, new_data); |
|
|
|
T* old_data; |
|
{ |
|
std::lock_guard<std::mutex> lock(this->_mutex); |
|
old_data = _asyncdata; |
|
_asyncdata = new_data; |
|
_asyncsize = count; |
|
_signaled = false; |
|
} |
|
this->NonBlockingCall(nullptr); |
|
|
|
delete[] old_data; |
|
} |
|
|
|
template <class T> |
|
inline void AsyncProgressWorker<T>::Signal() { |
|
{ |
|
std::lock_guard<std::mutex> lock(this->_mutex); |
|
_signaled = true; |
|
} |
|
this->NonBlockingCall(static_cast<T*>(nullptr)); |
|
} |
|
|
|
template <class T> |
|
inline void AsyncProgressWorker<T>::ExecutionProgress::Signal() const { |
|
this->_worker->Signal(); |
|
} |
|
|
|
template <class T> |
|
inline void AsyncProgressWorker<T>::ExecutionProgress::Send( |
|
const T* data, size_t count) const { |
|
_worker->SendProgress_(data, count); |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Async Progress Queue Worker class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
template <class T> |
|
inline AsyncProgressQueueWorker<T>::AsyncProgressQueueWorker( |
|
const Function& callback) |
|
: AsyncProgressQueueWorker(callback, "generic") {} |
|
|
|
template <class T> |
|
inline AsyncProgressQueueWorker<T>::AsyncProgressQueueWorker( |
|
const Function& callback, const char* resource_name) |
|
: AsyncProgressQueueWorker( |
|
callback, resource_name, Object::New(callback.Env())) {} |
|
|
|
template <class T> |
|
inline AsyncProgressQueueWorker<T>::AsyncProgressQueueWorker( |
|
const Function& callback, const char* resource_name, const Object& resource) |
|
: AsyncProgressQueueWorker( |
|
Object::New(callback.Env()), callback, resource_name, resource) {} |
|
|
|
template <class T> |
|
inline AsyncProgressQueueWorker<T>::AsyncProgressQueueWorker( |
|
const Object& receiver, const Function& callback) |
|
: AsyncProgressQueueWorker(receiver, callback, "generic") {} |
|
|
|
template <class T> |
|
inline AsyncProgressQueueWorker<T>::AsyncProgressQueueWorker( |
|
const Object& receiver, const Function& callback, const char* resource_name) |
|
: AsyncProgressQueueWorker( |
|
receiver, callback, resource_name, Object::New(callback.Env())) {} |
|
|
|
template <class T> |
|
inline AsyncProgressQueueWorker<T>::AsyncProgressQueueWorker( |
|
const Object& receiver, |
|
const Function& callback, |
|
const char* resource_name, |
|
const Object& resource) |
|
: AsyncProgressWorkerBase<std::pair<T*, size_t>>( |
|
receiver, |
|
callback, |
|
resource_name, |
|
resource, |
|
/** unlimited queue size */ 0) {} |
|
|
|
#if NAPI_VERSION > 4 |
|
template <class T> |
|
inline AsyncProgressQueueWorker<T>::AsyncProgressQueueWorker(Napi::Env env) |
|
: AsyncProgressQueueWorker(env, "generic") {} |
|
|
|
template <class T> |
|
inline AsyncProgressQueueWorker<T>::AsyncProgressQueueWorker( |
|
Napi::Env env, const char* resource_name) |
|
: AsyncProgressQueueWorker(env, resource_name, Object::New(env)) {} |
|
|
|
template <class T> |
|
inline AsyncProgressQueueWorker<T>::AsyncProgressQueueWorker( |
|
Napi::Env env, const char* resource_name, const Object& resource) |
|
: AsyncProgressWorkerBase<std::pair<T*, size_t>>( |
|
env, resource_name, resource, /** unlimited queue size */ 0) {} |
|
#endif |
|
|
|
template <class T> |
|
inline void AsyncProgressQueueWorker<T>::Execute() { |
|
ExecutionProgress progress(this); |
|
Execute(progress); |
|
} |
|
|
|
template <class T> |
|
inline void AsyncProgressQueueWorker<T>::OnWorkProgress( |
|
std::pair<T*, size_t>* datapair) { |
|
if (datapair == nullptr) { |
|
return; |
|
} |
|
|
|
T* data = datapair->first; |
|
size_t size = datapair->second; |
|
|
|
this->OnProgress(data, size); |
|
delete datapair; |
|
delete[] data; |
|
} |
|
|
|
template <class T> |
|
inline void AsyncProgressQueueWorker<T>::SendProgress_(const T* data, |
|
size_t count) { |
|
T* new_data = new T[count]; |
|
std::copy(data, data + count, new_data); |
|
|
|
auto pair = new std::pair<T*, size_t>(new_data, count); |
|
this->NonBlockingCall(pair); |
|
} |
|
|
|
template <class T> |
|
inline void AsyncProgressQueueWorker<T>::Signal() const { |
|
this->SendProgress_(static_cast<T*>(nullptr), 0); |
|
} |
|
|
|
template <class T> |
|
inline void AsyncProgressQueueWorker<T>::OnWorkComplete(Napi::Env env, |
|
napi_status status) { |
|
// Draining queued items in TSFN. |
|
AsyncProgressWorkerBase<std::pair<T*, size_t>>::OnWorkComplete(env, status); |
|
} |
|
|
|
template <class T> |
|
inline void AsyncProgressQueueWorker<T>::ExecutionProgress::Signal() const { |
|
_worker->SendProgress_(static_cast<T*>(nullptr), 0); |
|
} |
|
|
|
template <class T> |
|
inline void AsyncProgressQueueWorker<T>::ExecutionProgress::Send( |
|
const T* data, size_t count) const { |
|
_worker->SendProgress_(data, count); |
|
} |
|
#endif // NAPI_VERSION > 3 && NAPI_HAS_THREADS |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Memory Management class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline int64_t MemoryManagement::AdjustExternalMemory(Env env, |
|
int64_t change_in_bytes) { |
|
int64_t result; |
|
napi_status status = |
|
napi_adjust_external_memory(env, change_in_bytes, &result); |
|
NAPI_THROW_IF_FAILED(env, status, 0); |
|
return result; |
|
} |
|
|
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Version Management class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
inline uint32_t VersionManagement::GetNapiVersion(Env env) { |
|
uint32_t result; |
|
napi_status status = napi_get_version(env, &result); |
|
NAPI_THROW_IF_FAILED(env, status, 0); |
|
return result; |
|
} |
|
|
|
inline const napi_node_version* VersionManagement::GetNodeVersion(Env env) { |
|
const napi_node_version* result; |
|
napi_status status = napi_get_node_version(env, &result); |
|
NAPI_THROW_IF_FAILED(env, status, 0); |
|
return result; |
|
} |
|
|
|
#if NAPI_VERSION > 5 |
|
//////////////////////////////////////////////////////////////////////////////// |
|
// Addon<T> class |
|
//////////////////////////////////////////////////////////////////////////////// |
|
|
|
template <typename T> |
|
inline Object Addon<T>::Init(Env env, Object exports) { |
|
T* addon = new T(env, exports); |
|
env.SetInstanceData(addon); |
|
return addon->entry_point_; |
|
} |
|
|
|
template <typename T> |
|
inline T* Addon<T>::Unwrap(Object wrapper) { |
|
return wrapper.Env().GetInstanceData<T>(); |
|
} |
|
|
|
template <typename T> |
|
inline void Addon<T>::DefineAddon( |
|
Object exports, const std::initializer_list<AddonProp>& props) { |
|
DefineProperties(exports, props); |
|
entry_point_ = exports; |
|
} |
|
|
|
template <typename T> |
|
inline Napi::Object Addon<T>::DefineProperties( |
|
Object object, const std::initializer_list<AddonProp>& props) { |
|
const napi_property_descriptor* properties = |
|
reinterpret_cast<const napi_property_descriptor*>(props.begin()); |
|
size_t size = props.size(); |
|
napi_status status = |
|
napi_define_properties(object.Env(), object, size, properties); |
|
NAPI_THROW_IF_FAILED(object.Env(), status, object); |
|
for (size_t idx = 0; idx < size; idx++) |
|
T::AttachPropData(object.Env(), object, &properties[idx]); |
|
return object; |
|
} |
|
#endif // NAPI_VERSION > 5 |
|
|
|
#if NAPI_VERSION > 2 |
|
template <typename Hook, typename Arg> |
|
Env::CleanupHook<Hook, Arg> Env::AddCleanupHook(Hook hook, Arg* arg) { |
|
return CleanupHook<Hook, Arg>(*this, hook, arg); |
|
} |
|
|
|
template <typename Hook> |
|
Env::CleanupHook<Hook> Env::AddCleanupHook(Hook hook) { |
|
return CleanupHook<Hook>(*this, hook); |
|
} |
|
|
|
template <typename Hook, typename Arg> |
|
Env::CleanupHook<Hook, Arg>::CleanupHook() { |
|
data = nullptr; |
|
} |
|
|
|
template <typename Hook, typename Arg> |
|
Env::CleanupHook<Hook, Arg>::CleanupHook(Napi::Env env, Hook hook) |
|
: wrapper(Env::CleanupHook<Hook, Arg>::Wrapper) { |
|
data = new CleanupData{std::move(hook), nullptr}; |
|
napi_status status = napi_add_env_cleanup_hook(env, wrapper, data); |
|
if (status != napi_ok) { |
|
delete data; |
|
data = nullptr; |
|
} |
|
} |
|
|
|
template <typename Hook, typename Arg> |
|
Env::CleanupHook<Hook, Arg>::CleanupHook(Napi::Env env, Hook hook, Arg* arg) |
|
: wrapper(Env::CleanupHook<Hook, Arg>::WrapperWithArg) { |
|
data = new CleanupData{std::move(hook), arg}; |
|
napi_status status = napi_add_env_cleanup_hook(env, wrapper, data); |
|
if (status != napi_ok) { |
|
delete data; |
|
data = nullptr; |
|
} |
|
} |
|
|
|
template <class Hook, class Arg> |
|
bool Env::CleanupHook<Hook, Arg>::Remove(Env env) { |
|
napi_status status = napi_remove_env_cleanup_hook(env, wrapper, data); |
|
delete data; |
|
data = nullptr; |
|
return status == napi_ok; |
|
} |
|
|
|
template <class Hook, class Arg> |
|
bool Env::CleanupHook<Hook, Arg>::IsEmpty() const { |
|
return data == nullptr; |
|
} |
|
#endif // NAPI_VERSION > 2 |
|
|
|
#ifdef NAPI_CPP_CUSTOM_NAMESPACE |
|
} // namespace NAPI_CPP_CUSTOM_NAMESPACE |
|
#endif |
|
|
|
} // namespace Napi |
|
|
|
#endif // SRC_NAPI_INL_H_
|
|
|