1 /* 2 * Copyright (c) 2024 Huawei Device Co., Ltd. 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 * See the License for the specific language governing permissions and 13 * limitations under the License. 14 */ 15 16 #ifndef NAPI_ARK_INTEROP_NAPI_H 17 #define NAPI_ARK_INTEROP_NAPI_H 18 19 #include <cstdint> 20 #include <cstddef> 21 #include <iostream> 22 23 #include "ark_interop_macro.h" 24 25 DECL_START 26 27 /** 28 * es6 types (corresponds to typeof) 29 */ 30 typedef enum { 31 N_UNDEFINED, 32 N_NULL, 33 N_NUMBER, 34 N_BOOL, 35 N_BIGINT, 36 N_STRING, 37 N_SYMBOL, 38 N_OBJECT, 39 N_FUNCTION, 40 N_EXTERNAL, 41 } ARKTS_ValueType; 42 43 /** 44 * js object property descriptor attribute 45 */ 46 typedef enum { 47 N_WRITABLE = 0x1, 48 N_ENUMERABLE = 0x2, 49 N_CONFIGURABLE = 0x4, 50 } ARKTS_PropertyFlag; 51 52 typedef struct ARKTS_Value_* ARKTS_Value; 53 typedef struct ARKTS_Env_* ARKTS_Env; 54 typedef struct ARKTS_CallInfo_* ARKTS_CallInfo; 55 typedef struct ARKTS_Result_* ARKTS_Result; 56 /** 57 * be caution: ARKTS_Promise is not ARKTS_Value, you may not cast ARKTS_Promise to ARKTS_Value. 58 */ 59 typedef struct ARKTS_Promise_* ARKTS_Promise; 60 typedef struct ARKTS_Scope_* ARKTS_Scope; 61 typedef struct ARKTS_Global_* ARKTS_Global; 62 typedef struct ARKTS_Engine_* ARKTS_Engine; 63 64 typedef ARKTS_Result (*ARKTS_Callback)(ARKTS_CallInfo); 65 typedef ARKTS_Value (*ARKTS_ModuleExporter)(ARKTS_Env env, ARKTS_Value); 66 67 EXPORT ARKTS_Value ARKTS_GetGlobalConstant(ARKTS_Env env); 68 EXPORT uint64_t ARKTS_GetPosixThreadId(); 69 70 EXPORT ARKTS_ValueType ARKTS_GetValueType(ARKTS_Env env, ARKTS_Value src); 71 EXPORT bool ARKTS_StrictEqual(ARKTS_Env env, ARKTS_Value a, ARKTS_Value b); 72 73 EXPORT double ARKTS_GetValueNumber(ARKTS_Value value); 74 EXPORT bool ARKTS_IsNumber(ARKTS_Value value); 75 EXPORT ARKTS_Value ARKTS_CreateF64(double value); 76 77 EXPORT int32_t ARKTS_GetValueUtf8(ARKTS_Env env, ARKTS_Value value, int32_t capacity, char* buffer); 78 EXPORT int32_t ARKTS_GetValueUtf8Size(ARKTS_Env env, ARKTS_Value value); 79 EXPORT ARKTS_Value ARKTS_CreateUtf8(ARKTS_Env env, const char* value, int32_t size); 80 /** 81 * the result requires manually free, use ARKTS_FreeCString 82 */ 83 EXPORT const char* ARKTS_GetValueCString(ARKTS_Env env, ARKTS_Value value); 84 EXPORT void ARKTS_FreeCString(const char* src); 85 EXPORT bool ARKTS_IsString(ARKTS_Env env, ARKTS_Value value); 86 87 EXPORT ARKTS_Value ARKTS_CreateFunc(ARKTS_Env env, int64_t lambdaId); 88 /** 89 * logically equals to typeof(value) == "function" 90 */ 91 EXPORT bool ARKTS_IsCallable(ARKTS_Env env, ARKTS_Value value); 92 93 EXPORT bool ARKTS_IsClass(ARKTS_Env env, ARKTS_Value value); 94 EXPORT ARKTS_Value ARKTS_CreateClass(ARKTS_Env env, int64_t lambdaId, ARKTS_Value super); 95 EXPORT ARKTS_Value ARKTS_GetPrototype(ARKTS_Env env, ARKTS_Value value); 96 EXPORT bool ARKTS_InstanceOf(ARKTS_Env env, ARKTS_Value object, ARKTS_Value clazz); 97 98 EXPORT ARKTS_Env ARKTS_GetCallEnv(ARKTS_CallInfo info); 99 EXPORT uint32_t ARKTS_GetArgCount(ARKTS_CallInfo info); 100 EXPORT ARKTS_Value ARKTS_GetArg(ARKTS_CallInfo info, uint32_t index); 101 EXPORT ARKTS_Value ARKTS_GetThisArg(ARKTS_CallInfo info); 102 103 EXPORT ARKTS_Value ARKTS_Call(ARKTS_Env env, ARKTS_Value func, ARKTS_Value thisArg, 104 int32_t numArgs, ARKTS_Value args[]); 105 EXPORT ARKTS_Value ARKTS_New(ARKTS_Env env, ARKTS_Value clazz, int32_t numArgs, ARKTS_Value args[]); 106 107 EXPORT ARKTS_Value ARKTS_CreateNull(); 108 EXPORT bool ARKTS_IsNull(ARKTS_Value value); 109 EXPORT ARKTS_Value ARKTS_CreateUndefined(); 110 EXPORT bool ARKTS_IsUndefined(ARKTS_Value value); 111 EXPORT ARKTS_Value ARKTS_CreateBool(bool value); 112 EXPORT bool ARKTS_IsBool(ARKTS_Value value); 113 EXPORT bool ARKTS_GetValueBool(ARKTS_Value value); 114 115 EXPORT ARKTS_Value ARKTS_CreateObject(ARKTS_Env env); 116 /** 117 * js types excludes [number, boolean, null, undefined] are JSHeapObject 118 */ 119 EXPORT bool ARKTS_IsHeapObject(ARKTS_Value value); 120 121 // only available for JSObject, any other heap object(like JSArray, JSProxy...) supposed to call it's type-specific api 122 EXPORT bool ARKTS_IsObject(ARKTS_Env env, ARKTS_Value value); 123 EXPORT bool ARKTS_HasOwnProperty(ARKTS_Env env, ARKTS_Value jobj, ARKTS_Value jkey); 124 EXPORT ARKTS_Value ARKTS_EnumOwnProperties(ARKTS_Env env, ARKTS_Value jobj); 125 EXPORT void ARKTS_DefineOwnProperty(ARKTS_Env env, ARKTS_Value jobj, ARKTS_Value jkey, 126 ARKTS_Value jvalue, ARKTS_PropertyFlag attrs); 127 128 typedef struct ARKTS_Accessor_ { 129 ARKTS_Value getter; 130 ARKTS_Value setter; 131 ARKTS_PropertyFlag attrs; 132 } ARKTS_Accessor; 133 134 EXPORT void ARKTS_DefineAccessors(ARKTS_Env env, ARKTS_Value jobj, ARKTS_Value jkey, ARKTS_Accessor accessor); 135 EXPORT void ARKTS_SetProperty(ARKTS_Env env, ARKTS_Value jobj, ARKTS_Value jkey, ARKTS_Value jvalue); 136 EXPORT ARKTS_Value ARKTS_GetProperty(ARKTS_Env env, ARKTS_Value jobj, ARKTS_Value jkey); 137 138 EXPORT ARKTS_Value ARKTS_CreateArray(ARKTS_Env env, uint32_t size); 139 EXPORT ARKTS_Value ARKTS_CreateArrayWithInit(ARKTS_Env env, uint32_t size, ARKTS_Value data[]); 140 EXPORT uint32_t ARKTS_GetArrayLength(ARKTS_Env env, ARKTS_Value array); 141 EXPORT void ARKTS_SetElement(ARKTS_Env env, ARKTS_Value array, uint32_t index, ARKTS_Value value); 142 EXPORT ARKTS_Value ARKTS_GetElement(ARKTS_Env env, ARKTS_Value array, uint32_t index); 143 EXPORT bool ARKTS_IsArray(ARKTS_Env env, ARKTS_Value value); 144 145 EXPORT ARKTS_Global ARKTS_CreateGlobal(ARKTS_Env env, ARKTS_Value value); 146 EXPORT ARKTS_Value ARKTS_GetGlobalValue(ARKTS_Global global); 147 EXPORT void ARKTS_DisposeGlobal(ARKTS_Env env, ARKTS_Global global); 148 149 EXPORT ARKTS_Value ARKTS_CreateExternal(ARKTS_Env env, void* data); 150 EXPORT bool ARKTS_IsExternal(ARKTS_Env env, ARKTS_Value value); 151 EXPORT void* ARKTS_GetExternalData(ARKTS_Env env, ARKTS_Value value); 152 153 EXPORT ARKTS_Value ARKTS_CreateSymbol(ARKTS_Env env, const char* description, int32_t length); 154 EXPORT bool ARKTS_IsSymbol(ARKTS_Env env, ARKTS_Value value); 155 EXPORT const char* ARKTS_GetSymbolDesc(ARKTS_Env env, ARKTS_Value value); 156 157 EXPORT ARKTS_Engine ARKTS_CreateEngine(); 158 EXPORT void* ARKTS_GetNAPIEnv(ARKTS_Engine engine); 159 EXPORT void ARKTS_DestroyEngine(ARKTS_Engine engine); 160 EXPORT ARKTS_Env ARKTS_GetContext(ARKTS_Engine engine); 161 EXPORT ARKTS_Engine ARKTS_CreateEngineWithNewThread(); 162 EXPORT uint64_t ARKTS_GetThreadIdOfEngine(ARKTS_Engine engine); 163 164 EXPORT bool ARKTS_LoadEntryFromAbc(ARKTS_Engine engine, const char* filePath, const char* entryPoint, 165 bool forceReload); 166 EXPORT ARKTS_Value ARKTS_ImportFromEntry(ARKTS_Engine engine, const char* entryPoint, const char* importName); 167 168 EXPORT ARKTS_Value ARKTS_Require(ARKTS_Env env, const char* target, bool isNativeModule, bool isAppModule, 169 const char* relativePath); 170 171 /** 172 * promise in js and native are in different forms, 173 * ARKTS_Promise the native form, ARKTS_Value is the js form, never cast one to another 174 * the interface returns both forms, native ARKTS_Promise returns by params 'out', 175 * ARKTS_Promise won't be collected until ARKTS_PromiseCapabilityResolve or ARKTS_PromiseCapabilityReject 176 */ 177 EXPORT ARKTS_Promise ARKTS_CreatePromiseCapability(ARKTS_Env env); 178 EXPORT ARKTS_Value ARKTS_GetPromiseFromCapability(ARKTS_Env env, ARKTS_Promise prom); 179 EXPORT void ARKTS_PromiseCapabilityResolve(ARKTS_Env env, ARKTS_Promise prom, ARKTS_Value result); 180 EXPORT void ARKTS_PromiseCapabilityReject(ARKTS_Env env, ARKTS_Promise prom, ARKTS_Value result); 181 EXPORT bool ARKTS_IsPromise(ARKTS_Env env, ARKTS_Value value); 182 EXPORT ARKTS_Value ARKTS_PromiseThen(ARKTS_Env env, ARKTS_Value prom, ARKTS_Value onFulfilled, 183 ARKTS_Value onRejected); 184 EXPORT void ARKTS_PromiseCatch(ARKTS_Env env, ARKTS_Value prom, ARKTS_Value callback); 185 186 EXPORT void ARKTS_CreateAsyncTask(ARKTS_Env env, int64_t callbackId); 187 188 /** 189 * if native func call js function, GC would be triggered and objects created by native would be collected. 190 * objects created in scope will keep alive 191 * scope will close by ARKTS_Return 192 */ 193 EXPORT ARKTS_Scope ARKTS_OpenScope(ARKTS_Env env); 194 EXPORT void ARKTS_CloseScope(ARKTS_Env env, ARKTS_Scope scope); 195 EXPORT ARKTS_Result ARKTS_Return(ARKTS_Env env, ARKTS_Scope scope, ARKTS_Value value); 196 197 /** 198 * if error supposed to be catch by js, returns asap, 199 * some native api may lead to native exception handling procedural 200 */ 201 EXPORT void ARKTS_Throw(ARKTS_Env env, ARKTS_Value error); 202 203 EXPORT ARKTS_Value ARKTS_CreateArrayBuffer(ARKTS_Env env, int32_t); 204 EXPORT ARKTS_Value ARKTS_CreateArrayBufferWithData(ARKTS_Env env, void* buffer, int32_t length, 205 int64_t finalizerHint); 206 EXPORT bool ARKTS_IsArrayBuffer(ARKTS_Env env, ARKTS_Value value); 207 EXPORT int32_t ARKTS_GetArrayBufferLength(ARKTS_Env env, ARKTS_Value value); 208 EXPORT void* ARKTS_GetArrayBufferRawPtr(ARKTS_Env env, ARKTS_Value value); 209 EXPORT int32_t ARKTS_ArrayBufferReadBytes(ARKTS_Env env, ARKTS_Value buffer, void* dest, int32_t count); 210 211 EXPORT ARKTS_Value ARKTS_CreateBigInt(ARKTS_Env env, int64_t value); 212 EXPORT ARKTS_Value ARKTS_CreateBigIntWithBytes(ARKTS_Env env, bool isNegative, int64_t size, const uint8_t bytes[]); 213 EXPORT bool ARKTS_IsBigInt(ARKTS_Env env, ARKTS_Value value); 214 EXPORT int64_t ARKTS_BigIntGetByteSize(ARKTS_Env env, ARKTS_Value value); 215 EXPORT void ARKTS_BigIntReadBytes(ARKTS_Env env, ARKTS_Value value, bool* isNegative, 216 int64_t byteCount, uint8_t bytes[]); 217 218 EXPORT void ARKTS_InitEventHandle(ARKTS_Env env); 219 220 EXPORT void* ARKTS_GetGlobalNapiEnv(ARKTS_Env env); 221 222 DECL_END 223 224 #endif //NAPI_ARK_INTEROP_NAPI_H 225