#ifndef SRC_JS_NATIVE_API_V8_H_ #define SRC_JS_NATIVE_API_V8_H_ // This file needs to be compatible with C compilers. #include // NOLINT(modernize-deprecated-headers) #include "js_native_api_types.h" #include "js_native_api_v8_internals.h" struct napi_env__ { explicit napi_env__(v8::Local context) : isolate(context->GetIsolate()), context_persistent(isolate, context) { CHECK_EQ(isolate, context->GetIsolate()); } virtual ~napi_env__() = default; v8::Isolate* const isolate; // Shortcut for context()->GetIsolate() v8impl::Persistent context_persistent; inline v8::Local context() const { return v8impl::PersistentToLocal::Strong(context_persistent); } inline void Ref() { refs++; } inline void Unref() { if ( --refs == 0) delete this; } virtual bool can_call_into_js() const { return true; } v8impl::Persistent last_exception; napi_extended_error_info last_error; int open_handle_scopes = 0; int open_callback_scopes = 0; int refs = 1; }; static inline napi_status napi_clear_last_error(napi_env env) { env->last_error.error_code = napi_ok; // TODO(boingoing): Should this be a callback? env->last_error.engine_error_code = 0; env->last_error.engine_reserved = nullptr; return napi_ok; } static inline napi_status napi_set_last_error(napi_env env, napi_status error_code, uint32_t engine_error_code = 0, void* engine_reserved = nullptr) { env->last_error.error_code = error_code; env->last_error.engine_error_code = engine_error_code; env->last_error.engine_reserved = engine_reserved; return error_code; } #define RETURN_STATUS_IF_FALSE(env, condition, status) \ do { \ if (!(condition)) { \ return napi_set_last_error((env), (status)); \ } \ } while (0) #define CHECK_ENV(env) \ do { \ if ((env) == nullptr) { \ return napi_invalid_arg; \ } \ } while (0) #define CHECK_ARG(env, arg) \ RETURN_STATUS_IF_FALSE((env), ((arg) != nullptr), napi_invalid_arg) #define CHECK_MAYBE_EMPTY(env, maybe, status) \ RETURN_STATUS_IF_FALSE((env), !((maybe).IsEmpty()), (status)) // NAPI_PREAMBLE is not wrapped in do..while: try_catch must have function scope #define NAPI_PREAMBLE(env) \ CHECK_ENV((env)); \ RETURN_STATUS_IF_FALSE((env), \ (env)->last_exception.IsEmpty() && (env)->can_call_into_js(), \ napi_pending_exception); \ napi_clear_last_error((env)); \ v8impl::TryCatch try_catch((env)) #define CHECK_TO_TYPE(env, type, context, result, src, status) \ do { \ CHECK_ARG((env), (src)); \ auto maybe = v8impl::V8LocalValueFromJsValue((src))->To##type((context)); \ CHECK_MAYBE_EMPTY((env), maybe, (status)); \ (result) = maybe.ToLocalChecked(); \ } while (0) #define CHECK_TO_FUNCTION(env, result, src) \ do { \ CHECK_ARG((env), (src)); \ v8::Local v8value = v8impl::V8LocalValueFromJsValue((src)); \ RETURN_STATUS_IF_FALSE((env), v8value->IsFunction(), napi_invalid_arg); \ (result) = v8value.As(); \ } while (0) #define CHECK_TO_OBJECT(env, context, result, src) \ CHECK_TO_TYPE((env), Object, (context), (result), (src), napi_object_expected) #define CHECK_TO_STRING(env, context, result, src) \ CHECK_TO_TYPE((env), String, (context), (result), (src), napi_string_expected) #define GET_RETURN_STATUS(env) \ (!try_catch.HasCaught() ? napi_ok \ : napi_set_last_error((env), napi_pending_exception)) #define THROW_RANGE_ERROR_IF_FALSE(env, condition, error, message) \ do { \ if (!(condition)) { \ napi_throw_range_error((env), (error), (message)); \ return napi_set_last_error((env), napi_generic_failure); \ } \ } while (0) template void NapiCallIntoModule(napi_env env, T&& call, U&& handle_exception) { int open_handle_scopes = env->open_handle_scopes; int open_callback_scopes = env->open_callback_scopes; napi_clear_last_error(env); call(); CHECK_EQ(env->open_handle_scopes, open_handle_scopes); CHECK_EQ(env->open_callback_scopes, open_callback_scopes); if (!env->last_exception.IsEmpty()) { handle_exception(env->last_exception.Get(env->isolate)); env->last_exception.Reset(); } } template void NapiCallIntoModuleThrow(napi_env env, T&& call) { NapiCallIntoModule(env, call, [&](v8::Local value) { env->isolate->ThrowException(value); }); } namespace v8impl { //=== Conversion between V8 Handles and napi_value ======================== // This asserts v8::Local<> will always be implemented with a single // pointer field so that we can pass it around as a void*. static_assert(sizeof(v8::Local) == sizeof(napi_value), "Cannot convert between v8::Local and napi_value"); inline napi_value JsValueFromV8LocalValue(v8::Local local) { return reinterpret_cast(*local); } inline v8::Local V8LocalValueFromJsValue(napi_value v) { v8::Local local; memcpy(static_cast(&local), &v, sizeof(v)); return local; } // Adapter for napi_finalize callbacks. class Finalizer { protected: Finalizer(napi_env env, napi_finalize finalize_callback, void* finalize_data, void* finalize_hint) : _env(env), _finalize_callback(finalize_callback), _finalize_data(finalize_data), _finalize_hint(finalize_hint) { } ~Finalizer() = default; public: static Finalizer* New(napi_env env, napi_finalize finalize_callback = nullptr, void* finalize_data = nullptr, void* finalize_hint = nullptr) { return new Finalizer( env, finalize_callback, finalize_data, finalize_hint); } static void Delete(Finalizer* finalizer) { delete finalizer; } protected: napi_env _env; napi_finalize _finalize_callback; void* _finalize_data; void* _finalize_hint; bool _finalize_ran = false; }; class TryCatch : public v8::TryCatch { public: explicit TryCatch(napi_env env) : v8::TryCatch(env->isolate), _env(env) {} ~TryCatch() { if (HasCaught()) { _env->last_exception.Reset(_env->isolate, Exception()); } } private: napi_env _env; }; } // end of namespace v8impl #endif // SRC_JS_NATIVE_API_V8_H_