jsvm_types.h
概述
提供JSVM-API类型定义。通过API接口为开发者提供独立、标准、完整的JavaScript引擎能力，包括管理引擎生命周期、编译运行JS代码、实现JS/C++跨语言调用、拍摄快照等。
引用文件： <ark_runtime/jsvm_types.h>
库： libjsvm.so
系统能力： SystemCapability.ArkCompiler.JSVM
起始版本： 11
相关模块： JSVM
汇总
结构体
| 名称 | typedef关键字 | 描述 |
|---|---|---|
| JSVM_CallbackStruct | JSVM_CallbackStruct | 用户提供的native回调函数的指针和数据，这些函数通过JSVM-API接口暴露给JavaScript。 |
| JSVM_HeapStatistics | JSVM_HeapStatistics | 用于保存有关JavaScript堆内存使用情况的统计信息。 |
| JSVM_InitOptions | JSVM_InitOptions | 初始化选项，用于初始化JavaScript虚拟机。 |
| JSVM_CreateVMOptions | JSVM_CreateVMOptions | 创建JavaScript虚拟机的选项。 |
| JSVM_VMInfo | JSVM_VMInfo | JavaScript虚拟机信息。 |
| JSVM_PropertyDescriptor | JSVM_PropertyDescriptor | 属性描述符。 |
| JSVM_ExtendedErrorInfo | JSVM_ExtendedErrorInfo | 扩展的异常信息。 |
| JSVM_TypeTag | JSVM_TypeTag | 类型标记，存储为两个无符号64位整数的128位值。作为一个UUID，通过它，JavaScript对象可以是"tagged"，以确保它们的类型保持不变。 |
| JSVM_PropertyHandlerConfigurationStruct | JSVM_PropertyHandlerConfigurationStruct | 当执行对象的getter、setter、deleter和enumerator操作时，该结构体中对应的函数回调将会触发。 |
| JSVM_ScriptOrigin | JSVM_ScriptOrigin | 某段JavaScript代码的原始信息，如sourceMap路径、源文件名、源文件中的起始行/列号等。 |
| JSVM_CompileOptions | JSVM_CompileOptions | 对应JSVM的编译选项，包含内容和ID。 |
| JSVM_CodeCache | JSVM_CodeCache | 对应JSVM代码缓存的地址与大小。 |
| JSVM_PropertyHandler | JSVM_PropertyHandler | 包含将class作为函数进行调用时所触发的回调函数的函数指针和访问实例对象属性时触发的回调函数的函数指针集。 |
| JSVM_DefineClassOptions | JSVM_DefineClassOptions | 定义Class的选项。 |
| JSVM_VM__* | JSVM_VM | 表示JavaScript虚拟机实例。 |
| JSVM_VMScope__* | JSVM_VMScope | 表示JavaScript虚拟机作用域。 |
| JSVM_EnvScope__* | JSVM_EnvScope | 表示用于控制附加到当前虚拟机实例的环境。只有当线程通过OH_JSVM_OpenEnvScope进入该环境的JSVM_EnvScope后，该环境才对线程的虚拟机实例可用。 |
| JSVM_Script__* | JSVM_Script | 表示一段JavaScript代码。 |
| JSVM_Env__* | JSVM_Env | 表示虚拟机特定状态的上下文环境，需要在调用native函数时作为参数传递，并且传递给后续任何的JSVM-API嵌套调用。 |
| JSVM_CpuProfiler__* | JSVM_CpuProfiler | 表示一个JavaScript CPU时间性能分析器。 |
| JSVM_Value__* | JSVM_Value | 表示JavaScript值。 |
| JSVM_Data__* | JSVM_Data | 表示一个 JavaScript Data。 |
| JSVM_Ref__* | JSVM_Ref | 表示JavaScript值的引用。 |
| JSVM_HandleScope__* | JSVM_HandleScope | 表示JavaScript值的作用域，用于控制和修改在特定范围内创建的对象的生命周期。通常，JSVM-API值是在JSVM_HandleScope的上下文中创建的。当从JavaScript调用native方法时，将存在默认JSVM_HandleScope。如果用户没有显式创建新的JSVM_HandleScope，将在默认JSVM_HandleScope中创建JSVM-API值。对于native方法执行之外的任何代码调用（例如，在libuv回调调用期间），模块需要在调用任何可能导致创建JavaScript值的函数之前创建一个作用域。JSVM_HandleScope是使用OH_JSVM_OpenHandleScope创建的，并使用OH_JSVM_CloseHandleScope销毁的。关闭作用域代表向GC指示在JSVM_HandleScope作用域的生命周期内创建的所有JSVM_Value将不再从当前堆的栈帧中引用。 |
| JSVM_EscapableHandleScope__* | JSVM_EscapableHandleScope | 表示一种特殊类型的handle scope，用于将在特定handle scope内创建的值返回到父作用域。 |
| JSVM_CallbackInfo__* | JSVM_CallbackInfo | 表示传递给回调函数的不透明数据类型。可用于获取调用该函数的上下文的附加信息。 |
| JSVM_Deferred__* | JSVM_Deferred | 表示Promise延迟对象。 |
| JSVM_PropertyHandlerConfigurationStruct* | JSVM_PropertyHandlerCfg | 包含属性监听回调的结构的指针类型。 |
| JSVM_CallbackStruct* | JSVM_Callback | 用户提供的native函数的函数指针类型，这些函数通过JSVM-API接口暴露给JavaScript。 |
| JSVM_CompileProfile | JSVM_CompileProfile | 与JSVM_COMPILE_COMPILE_PROFILE一起传递的编译采样文件。 |
| JSVM_DeserializeResult | JSVM_DeserializeResult | 与JSVM_COMPILE_BACKGROUND_DESERIALIZE_RESULT一起传递的后台反序列化结果。 |
枚举
| 名称 | typedef关键字 | 描述 |
|---|---|---|
| JSVM_PropertyAttributes | JSVM_PropertyAttributes | 用于控制JavaScript对象属性的行为。 |
| JSVM_ValueType | JSVM_ValueType | 描述JSVM_Value的类型。 |
| JSVM_TypedarrayType | JSVM_TypedarrayType | 描述TypedArray的类型。 |
| JSVM_Status | JSVM_Status | 表示JSVM-API调用成功或失败的完整状态码。 |
| JSVM_KeyCollectionMode | JSVM_KeyCollectionMode | 限制查找属性的范围。 |
| JSVM_KeyFilter | JSVM_KeyFilter | 属性过滤器，可以通过使用or来构造一个复合过滤器。 |
| JSVM_KeyConversion | JSVM_KeyConversion | 键转换选项。 |
| JSVM_MemoryPressureLevel | JSVM_MemoryPressureLevel | 内存压力水平。 |
| JSVM_CompileMode | JSVM_CompileMode | JSVM编译模式。 |
| JSVM_CompileOptionId | JSVM_CompileOptionId | JSVM编译选项ID。 |
| JSVM_RegExpFlags | JSVM_RegExpFlags | 正则表达式标志位。它们可以用来启用一组标志。 |
| JSVM_InitializedFlag | JSVM_InitializedFlag | 初始化方式的标志位。 |
| JSVM_WasmOptLevel | JSVM_WasmOptLevel | WebAssembly 函数优化等级。 |
| JSVM_CacheType | JSVM_CacheType | 缓存类型。 |
| JSVM_MicrotaskPolicy | JSVM_MicrotaskPolicy | JSVM 微任务执行策略。 |
| JSVM_TraceCategory | JSVM_TraceCategory | JSVM 内部 Trace 事件的类别。 |
| JSVM_CBTriggerTimeForGC | JSVM_CBTriggerTimeForGC | 触发回调函数的时机。 |
| JSVM_GCType | JSVM_GCType | GC类型。 |
| JSVM_GCCallbackFlags | JSVM_GCCallbackFlags | GC回调函数标记。 |
| JSVM_PromiseRejectEvent | JSVM_PromiseRejectEvent | promise-reject事件。 |
| JSVM_MessageErrorLevel | JSVM_MessageErrorLevel | message的报错级别。 |
| JSVM_DefineClassOptionsId | JSVM_DefineClassOptionsId | 定义Class的选项ID。 |
| JSVM_DebugOption | JSVM_DebugOption | 调试选项。 |
函数
变量
| 名称 | typedef关键字 | 描述 |
|---|---|---|
| uint16_t | char16_t | 为uint16_t创建一个别名——char16_t。 这段代码的核心目的是确保 char16_t 这个类型在所有目标编译环境中都可用，即使在一些不支持它的旧环境里。char16_t 是 C++11 标准中引入的一个新的基本数据类型，专门用于存储16位字符，通常用来表示UTF-16编码的字符。 如果编译器本身不认识char16_t，手动创建一个底层实现是16位无符号的整数类型。前置生效条件为：当前编译器——非C++编译器编译 ||是微软Visual C++编译器且版本早于Visual Studio 2015（不含）。 |
枚举类型说明
JSVM_PropertyAttributes
enum JSVM_PropertyAttributes
描述
用于控制JavaScript对象属性的行为。
起始版本： 11
| 枚举项 | 描述 |
|---|---|
| JSVM_DEFAULT = 0 | 没有在属性上设置显式属性。 |
| JSVM_WRITABLE = 1 << 0 | 该属性是可写的。 |
| JSVM_ENUMERABLE = 1 << 1 | 该属性是可枚举的。 |
| JSVM_CONFIGURABLE = 1 << 2 | 该属性是可配置的。 |
| JSVM_NO_RECEIVER_CHECK = 1 << 3 | 用于标记本地方法的接收器无需进行检查。如果未设置 JSVM_NO_RECEIVER_CHECK，则该方法仅接受定义类的实例作为接收器，否则会向 JSVM 抛出异常“类型错误：非法调用”。 |
| JSVM_STATIC = 1 << 10 | 该属性将被定义为类的静态属性，而不是默认的实例属性。这仅由OH_JSVM_DefineClass使用。 |
| JSVM_DEFAULT_METHOD = JSVM_WRITABLE |JSVM_CONFIGURABLE | 就像JS类中的方法一样，该属性是可配置和可写的，但不可枚举。 |
| JSVM_METHOD_NO_RECEIVER_CHECK = JSVM_DEFAULT_METHOD |JSVM_NO_RECEIVER_CHECK | 无需检查接收者的类方法。 |
| JSVM_DEFAULT_JSPROPERTY = JSVM_WRITABLE |JSVM_ENUMERABLE |JSVM_CONFIGURABLE | 就像JavaScript中通过赋值设置的属性一样，属性是可写、可枚举和可配置的。 |
| JSVM_JSPROPERTY_NO_RECEIVER_CHECK = JSVM_DEFAULT_JSPROPERTY |JSVM_NO_RECEIVER_CHECK | 无需检查接收者的对象属性。 |
JSVM_ValueType
enum JSVM_ValueType
描述
描述JSVM_Value的类型。
起始版本： 11
| 枚举项 | 描述 |
|---|---|
| JSVM_UNDEFINED | 未定义类型。 |
| JSVM_NULL | Null类型。 |
| JSVM_BOOLEAN | 布尔类型。 |
| JSVM_NUMBER | 数字类型。 |
| JSVM_STRING | 字符串类型。 |
| JSVM_SYMBOL | 符号类型。 |
| JSVM_OBJECT | 对象类型。 |
| JSVM_FUNCTION | 函数类型。 |
| JSVM_EXTERNAL | 外部类型。 |
| JSVM_BIGINT | bigint类型。 |
JSVM_TypedarrayType
enum JSVM_TypedarrayType
描述
描述TypedArray的类型。
起始版本： 11
| 枚举项 | 描述 |
|---|---|
| JSVM_INT8_ARRAY | int8类型。 |
| JSVM_UINT8_ARRAY | uint8类型。 |
| JSVM_UINT8_CLAMPED_ARRAY | uint8固定类型。 |
| JSVM_INT16_ARRAY | int16类型。 |
| JSVM_UINT16_ARRAY | uint16类型。 |
| JSVM_INT32_ARRAY | int32类型。 |
| JSVM_UINT32_ARRAY | uint32类型。 |
| JSVM_FLOAT32_ARRAY | float32类型。 |
| JSVM_FLOAT64_ARRAY | float64类型。 |
| JSVM_BIGINT64_ARRAY | bigint64类型。 |
| JSVM_BIGUINT64_ARRAY | biguint64类型。 |
JSVM_Status
enum JSVM_Status
描述
表示JSVM-API调用成功或失败的完整状态码。
起始版本： 11
| 枚举项 | 描述 |
|---|---|
| JSVM_OK | 成功状态。 |
| JSVM_INVALID_ARG | 无效的状态。 |
| JSVM_OBJECT_EXPECTED | 期待传入对象类型。 |
| JSVM_STRING_EXPECTED | 期望传入字符串类型。 |
| JSVM_NAME_EXPECTED | 期望传入名字类型。 |
| JSVM_FUNCTION_EXPECTED | 期待传入函数类型。 |
| JSVM_NUMBER_EXPECTED | 期待传入数字类型。 |
| JSVM_BOOLEAN_EXPECTED | 期待传入布尔类型。 |
| JSVM_ARRAY_EXPECTED | 期待传入数组类型。 |
| JSVM_GENERIC_FAILURE | 泛型失败状态。 |
| JSVM_PENDING_EXCEPTION | 挂起异常状态。 |
| JSVM_CANCELLED | 取消状态。 |
| JSVM_ESCAPE_CALLED_TWICE | 转义调用了两次。 |
| JSVM_HANDLE_SCOPE_MISMATCH | 句柄作用域不匹配。 |
| JSVM_CALLBACK_SCOPE_MISMATCH | 回调作用域不匹配。 |
| JSVM_QUEUE_FULL | 队列满。 |
| JSVM_CLOSING | 关闭中。 |
| JSVM_BIGINT_EXPECTED | 期望传入Bigint类型。 |
| JSVM_DATE_EXPECTED | 期望传入日期类型。 |
| JSVM_ARRAYBUFFER_EXPECTED | 期望传入ArrayBuffer类型。 |
| JSVM_DETACHABLE_ARRAYBUFFER_EXPECTED | 可分离的数组缓冲区预期状态。 |
| JSVM_WOULD_DEADLOCK | 将死锁状态。 |
| JSVM_NO_EXTERNAL_BUFFERS_ALLOWED | 不允许外部缓冲区。 |
| JSVM_CANNOT_RUN_JS | 不能执行JS。 |
| JSVM_INVALID_TYPE | 传入的参数为非法类型。 起始版本： 18 |
| JSVM_JIT_MODE_EXPECTED | 无 JIT 权限。 起始版本： 18 |
JSVM_KeyCollectionMode
enum JSVM_KeyCollectionMode
描述
限制查找属性的范围。
起始版本： 11
| 枚举项 | 描述 |
|---|---|
| JSVM_KEY_INCLUDE_PROTOTYPES | 也包含对象原型链上的属性。 |
| JSVM_KEY_OWN_ONLY | 仅包含对象自身属性。 |
JSVM_KeyFilter
enum JSVM_KeyFilter
描述
属性过滤器，可以通过使用or来构造一个复合过滤器。
起始版本： 11
| 枚举项 | 描述 |
|---|---|
| JSVM_KEY_ALL_PROPERTIES = 0 | 所有属性的键。 |
| JSVM_KEY_WRITABLE = 1 | 可写的键。 |
| JSVM_KEY_ENUMERABLE = 1 << 1 | 可枚举的键。 |
| JSVM_KEY_CONFIGURABLE = 1 << 2 | 可配置的键。 |
| JSVM_KEY_SKIP_STRINGS = 1 << 3 | 排除字符串类型的键。 |
| JSVM_KEY_SKIP_SYMBOLS = 1 << 4 | 排除符号类型的键。 |
JSVM_KeyConversion
enum JSVM_KeyConversion
描述
键转换选项。
起始版本： 11
| 枚举项 | 描述 |
|---|---|
| JSVM_KEY_KEEP_NUMBERS | 将返回整数索引的数字。 |
| JSVM_KEY_NUMBERS_TO_STRINGS | 将整数索引转换为字符串。 |
JSVM_MemoryPressureLevel
enum JSVM_MemoryPressureLevel
描述
内存压力水平。
起始版本： 11
| 枚举项 | 描述 |
|---|---|
| JSVM_MEMORY_PRESSURE_LEVEL_NONE | 无压力。 |
| JSVM_MEMORY_PRESSURE_LEVEL_MODERATE | 中等压力。 |
| JSVM_MEMORY_PRESSURE_LEVEL_CRITICAL | 临界压力。 |
| JSVM_MEMORY_PRESSURE_LEVEL_LOW_MEMORY | 通知系统内存不足，立即触发垃圾回收。 起始版本： 22 |
JSVM_CompileMode
enum JSVM_CompileMode
描述
当 id 为 JSVM_COMPILE_MODE 时，content 类型的每个值代表一种编译模式。
起始版本： 12
| 枚举项 | 描述 |
|---|---|
| JSVM_COMPILE_MODE_DEFAULT | 默认编译模式。 |
| JSVM_COMPILE_MODE_CONSUME_CODE_CACHE | 使用代码缓存的模式。 |
| JSVM_COMPILE_MODE_EAGER_COMPILE | 激进编译模式。 |
| JSVM_COMPILE_MODE_PRODUCE_COMPILE_PROFILE | 生成编译依赖的模式。 |
| JSVM_COMPILE_MODE_CONSUME_COMPILE_PROFILE | 使用编译依赖的模式。 |
JSVM_CompileOptionId
enum JSVM_CompileOptionId
描述
JSVM_CompileOptions 中的 id 对应类型，每个值有对应的 content 类型。JSVM_COMPILE_ENABLE_SOURCE_MAP 的类型为 bool，当 JSVM_ScriptOrigin 中的 sourceMapUrl 不为空时生效。
起始版本： 12
| 枚举项 | 描述 |
|---|---|
| JSVM_COMPILE_MODE | JSVM编译模式。 |
| JSVM_COMPILE_CODE_CACHE | JSVM代码缓存。 |
| JSVM_COMPILE_SCRIPT_ORIGIN | JSVM脚本来源。 |
| JSVM_COMPILE_COMPILE_PROFILE | JSVM编译依赖。 |
| JSVM_COMPILE_ENABLE_SOURCE_MAP | JSVM的 Source Map 的使能情况。 |
| JSVM_COMPILE_BACKGROUND_DESERIALIZE_RESULT | JSVM脚本的后台反序列化结果。 起始版本： 24 |
| JSVM_COMPILE_CODE_CACHE_REJECTED | JSVM字节码缓存是否被拒绝。 起始版本： 24 |
JSVM_RegExpFlags
enum JSVM_RegExpFlags
描述
正则表达式标志位。它们可以用来启用一组标志。
起始版本： 12
| 枚举项 | 描述 |
|---|---|
| JSVM_REGEXP_NONE = 0 | None模式。 |
| JSVM_REGEXP_GLOBAL = 1 << 0 | Global模式。 |
| JSVM_REGEXP_IGNORE_CASE = 1 << 1 | Ignore Case模式。 |
| JSVM_REGEXP_MULTILINE = 1 << 2 | Multiline模式。 |
| JSVM_REGEXP_STICKY = 1 << 3 | Sticky模式。 |
| JSVM_REGEXP_UNICODE = 1 << 4 | Unicode模式。 |
| JSVM_REGEXP_DOT_ALL = 1 << 5 | dotAll模式。 |
| JSVM_REGEXP_LINEAR = 1 << 6 | Linear模式。 |
| JSVM_REGEXP_HAS_INDICES = 1 << 7 | Has Indices模式。 |
| JSVM_REGEXP_UNICODE_SETS = 1 << 8 | Unicode Sets模式。 |
JSVM_InitializedFlag
enum JSVM_InitializedFlag
描述
初始化方式的标志位。
起始版本： 12
| 枚举项 | 描述 |
|---|---|
| JSVM_ZERO_INITIALIZED | 初始化为0。 |
| JSVM_UNINITIALIZED | 不做初始化。 |
JSVM_WasmOptLevel
enum JSVM_WasmOptLevel
描述
WebAssembly 函数优化等级。
起始版本： 12
| 枚举项 | 描述 |
|---|---|
| JSVM_WASM_OPT_BASELINE = 10 | baseline 优化等级。 |
| JSVM_WASM_OPT_HIGH = 20 | 高优化等级。 |
JSVM_CacheType
enum JSVM_CacheType
描述
缓存类型。
起始版本： 12
| 枚举项 | 描述 |
|---|---|
| JSVM_CACHE_TYPE_JS | JS 缓存, 由接口 OH_JSVM_CreateCodeCache 生成。 |
| JSVM_CACHE_TYPE_WASM | WebAssembly 缓存, 由接口 OH_JSVM_CreateWasmCache 生成。 |
JSVM_MicrotaskPolicy
enum JSVM_MicrotaskPolicy
描述
JSVM 微任务执行策略。
起始版本： 18
| 枚举项 | 描述 |
|---|---|
| JSVM_MICROTASK_EXPLICIT = 0 | 调用 OH_JSVM_PerformMicrotaskCheckpoint 方法后微任务执行。 |
| JSVM_MICROTASK_AUTO | JS 调用栈为 0 时自动执行微任务。默认模式。 |
JSVM_TraceCategory
enum JSVM_TraceCategory
描述
JSVM 内部 Trace 事件的类别。
起始版本： 18
| 枚举项 | 描述 |
|---|---|
| JSVM_TRACE_VM | 采集 JSVM 主要接口调用, 例如执行 js 脚本。 |
| JSVM_TRACE_COMPILE | 采集编译相关的接口调用, 例如后台编译。 |
| JSVM_TRACE_EXECUTE | 采集与运行状态相关的接口调用, 例如中断与微任务。 |
| JSVM_TRACE_RUNTIME | 采集外部函数调用相关信息。 |
| JSVM_TRACE_STACK_TRACE | 采集 JSVM 中堆栈相关信息。 |
| JSVM_TRACE_WASM | 采集主要的 WASM 相关接口调用, 例如编译与实例化 WASM 模块。 |
| JSVM_TRACE_WASM_DETAILED | 采集更多更细节的 WASM 相关接口调用，例如后台编译、跳板编译。 |
JSVM_CBTriggerTimeForGC
enum JSVM_CBTriggerTimeForGC
描述
触发回调函数的时机。
起始版本： 18
| 枚举项 | 描述 |
|---|---|
| JSVM_CB_TRIGGER_BEFORE_GC | 在GC之前触发回调函数。 |
| JSVM_CB_TRIGGER_AFTER_GC | 在GC之后触发回调函数。 |
JSVM_GCType
enum JSVM_GCType
描述
GC类型。
起始版本： 18
| 枚举项 | 描述 |
|---|---|
| JSVM_GC_TYPE_SCAVENGE = 1 << 0 | GC算法为Scavenge。 |
| JSVM_GC_TYPE_MINOR_MARK_COMPACT = 1 << 1 | GC算法为Minor-Mark-Compact。 |
| JSVM_GC_TYPE_MARK_SWEEP_COMPACT = 1 << 2 | GC算法为Mark-Sweep-Compact。 |
| JSVM_GC_TYPE_INCREMENTAL_MARKING = 1 << 3 | GC算法为Incremental-Marking。 |
| JSVM_GC_TYPE_PROCESS_WEAK_CALLBACKS = 1 << 4 | GC算法为Weak-Callbacks。 |
| JSVM_GC_TYPE_ALL = JSVM_GC_TYPE_SCAVENGE |JSVM_GC_TYPE_MINOR_MARK_COMPACT |JSVM_GC_TYPE_MARK_SWEEP_COMPACT |JSVM_GC_TYPE_INCREMENTAL_MARKING |JSVM_GC_TYPE_PROCESS_WEAK_CALLBACKS | 包含所有类型的GC算法。 |
JSVM_GCCallbackFlags
enum JSVM_GCCallbackFlags
描述
GC回调函数标记。
起始版本： 18
| 枚举项 | 描述 |
|---|---|
| JSVM_NO_GC_CALLBACK_FLAGS | 无回调函数标记。 |
| JSVM_GC_CALLBACK_CONSTRUCT_RETAINED_OBJECT_INFOS | 垃圾回收回调中将构建保留对象信息。 |
| JSVM_GC_CALLBACK_FORCED | 强制执行垃圾回收回调。 |
| JSVM_GC_CALLBACK_SYNCHRONOUS_PHANTOM_CALLBACK_PROCESSING | 同步处理幽灵对象回调。 |
| JSVM_GC_CALLBACK_COLLECT_ALL_AVAILABLE_GARBAGE | 垃圾回收过程中会收集所有可用的垃圾对象。 |
| JSVM_GC_CALLBACK_COLLECT_ALL_EXTERNAL_MEMORY | 垃圾回收时会收集所有的外部内存。 |
| JSVM_GC_CALLBACK_SCHEDULE_IDLE_GARBAGE_COLLECTION | 在空闲时调度垃圾回收。 |
JSVM_PromiseRejectEvent
enum JSVM_PromiseRejectEvent
描述
promise-reject事件。
起始版本： 18
| 枚举项 | 描述 |
|---|---|
| JSVM_PROMISE_REJECT_OTHER_REASONS = 0 | Promise被拒绝，但拒绝的原因未知或不明确。 |
| JSVM_PROMISE_REJECT_WITH_NO_HANDLER = 1 | Promise被拒绝但没有处理程序。 |
| JSVM_PROMISE_ADD_HANDLER_AFTER_REJECTED = 2 | Promise已被拒绝后，再添加处理程序。 |
| JSVM_PROMISE_REJECT_AFTER_RESOLVED = 3 | Promise已被解决后，再尝试拒绝该Promise。 |
| JSVM_PROMISE_RESOLVE_AFTER_RESOLVED = 4 | Promise已被解决后，再尝试解决该Promise。 |
JSVM_MessageErrorLevel
enum JSVM_MessageErrorLevel
描述
message的报错级别。
起始版本： 18
| 枚举项 | 描述 |
|---|---|
| JSVM_MESSAGE_LOG = (1 << 0) | Log级别的信息。 |
| JSVM_MESSAGE_DEBUG = (1 << 1) | Debug级别的信息。 |
| JSVM_MESSAGE_INFO = (1 << 2) | Info级别的信息。 |
| JSVM_MESSAGE_ERROR = (1 << 3) | Error级别的信息。 |
| JSVM_MESSAGE_WARNING = (1 << 4) | Warning级别的信息。 |
| JSVM_MESSAGE_ALL = JSVM_MESSAGE_LOG |JSVM_MESSAGE_DEBUG |JSVM_MESSAGE_INFO |JSVM_MESSAGE_ERROR |JSVM_MESSAGE_WARNING | 所有级别的信息。 |
JSVM_DefineClassOptionsId
enum JSVM_DefineClassOptionsId
描述
定义Class的选项ID。
起始版本： 18
| 枚举项 | 描述 |
|---|---|
| JSVM_DEFINE_CLASS_NORMAL | 在常规模式下定义Class。 |
| JSVM_DEFINE_CLASS_WITH_COUNT | 为所创建的Class预留指定数量的interfield槽位，在这些槽位中可以存放native-data。 |
| JSVM_DEFINE_CLASS_WITH_PROPERTY_HANDLER | 为所创建的Class设置监听拦截属性以及设置作为函数调用时回调函数。 |
JSVM_DebugOption
enum JSVM_DebugOption
描述
调试选项。
起始版本： 20
| 枚举项 | 描述 |
|---|---|
| JSVM_SCOPE_CHECK | scope校验功能。 |
函数说明
JSVM_Finalize()
typedef void (JSVM_CDECL* JSVM_Finalize)(JSVM_Env env,void* finalizeData,void* finalizeHint)
描述
函数指针类型，当native类型对象或数据与JS对象被关联时，传入该指针。该函数将会在关联的JS对象被GC回收时被调用，用以执行native的清理动作。
起始版本： 11
JSVM_FinalizeArrayBuffer()
#ifdef JSVM_EXPERIMENTAL
typedef void(JSVM_CDECL* JSVM_FinalizeArrayBuffer)(JSVM_Env env,void* finalizeData,void* finalizeHint,bool copied);
#endif // JSVM_EXPERIMENTAL
描述
注意：
此接口是实验性接口，需定义
JSVM_EXPERIMENTAL宏后方可使用。
函数指针类型，在调用OH_JSVM_CreateArrayBufferFromExternalMemory接口时，可传入该类型的函数调用。回调函数将会在关联的ArrayBuffer对象被回收时被调用，用以执行native的清理动作。使用JSVM_FinalizeArrayBuffer请遵循以下规则：
-
由于
JSVM_FinalizeArrayBuffer回调函数的调用时机具有不确定性（可能是GC期间，也可能是虚拟机销毁期间等），回调时JSVM环境可能已经销毁，因此JSVM_FinalizeArrayBuffer的env参数始终是NULL。 -
回调函数仅做资源释放，不要执行复杂逻辑。回调函数中不能调用其他JSVM API。
-
回调函数可能在非JSVM主线程上调用，如果回调需要访问共享状态，必须使用原子操作或锁进行同步。
-
根据
copied参数决定内存的释放策略，详见使用JSVM-API接口从外部内存创建ArrayBuffer。
起始版本： 26.0.0
JSVM_OutputStream()
typedef bool (JSVM_CDECL* JSVM_OutputStream)(const char* data,int size,void* streamData)
描述
ASCII输出流回调的函数指针类型。参数data是指输出的数据指针。参数size是指输出的数据大小。空数据指针指示流的结尾。参数streamData是指与回调一起传递给API函数的指针，该API函数向输出流生成数据。
起始版本： 12
返回：
| 类型 | 说明 |
|---|---|
| bool | 返回true表示流可以继续接收数据，返回false将中止流。 |
JSVM_HandlerForGC()
typedef void (JSVM_CDECL* JSVM_HandlerForGC)(JSVM_VM vm, JSVM_GCType gcType, JSVM_GCCallbackFlags flags, void* data)
描述
GC回调的函数指针类型。
起始版本： 18
JSVM_HandlerForOOMError()
typedef void (JSVM_CDECL* JSVM_HandlerForOOMError)(const char* location,const char* detail,bool isHeapOOM)
描述
OOM-Error回调的函数指针类型。
起始版本： 18
JSVM_HandlerForFatalError()
typedef void (JSVM_CDECL* JSVM_HandlerForFatalError)(const char* location,const char* message)
描述
Fatal-Error回调的函数指针类型。
起始版本： 18
JSVM_HandlerForPromiseReject()
typedef void (JSVM_CDECL* JSVM_HandlerForPromiseReject)(JSVM_Env env, JSVM_PromiseRejectEvent rejectEvent, JSVM_Value rejectInfo)
描述
Promise-Reject回调的函数指针类型。
起始版本： 18
你可能感兴趣的鸿蒙文章
openharmony 鸿蒙 capi-jsvm-jsvm-vminfo
openharmony 鸿蒙 capi-memory-purgmem
openharmony 鸿蒙 capi-jsvm-jsvm-callbackstruct8h
openharmony 鸿蒙 capi-jsvm-jsvm-deserializeresult
openharmony 鸿蒙 capi-jsvm-jsvm-propertydescriptor
openharmony 鸿蒙 js-apis-common-load-native-module