From 74dd551774c8de038e842ede35fcda108747f27f Mon Sep 17 00:00:00 2001
From: chenraozhong <chenraozhong1@huawei.com>
Date: Fri, 15 Nov 2024 14:47:15 +0800
Subject: [PATCH] Add jsvm microtasks API

Signed-off-by: wangyimin <wangyimin15@huawei.com>
---
 ark_runtime/jsvm/jsvm.h           | 12 ++++++++++++
 ark_runtime/jsvm/jsvm_types.h     | 14 ++++++++++++++
 ark_runtime/jsvm/libjsvm.ndk.json |  4 ++++
 3 files changed, 30 insertions(+)

diff --git a/ark_runtime/jsvm/jsvm.h b/ark_runtime/jsvm/jsvm.h
index 3f47366b4..8957632e6 100644
--- a/ark_runtime/jsvm/jsvm.h
+++ b/ark_runtime/jsvm/jsvm.h
@@ -121,6 +121,18 @@ JSVM_EXTERN JSVM_Status OH_JSVM_Init(const JSVM_InitOptions* options);
 JSVM_EXTERN JSVM_Status OH_JSVM_CreateVM(const JSVM_CreateVMOptions* options,
                                          JSVM_VM* result);
 
+/**
+ * @brief This function controls how Microtasks are invoked of the vm. If the method is not
+ * called, the default microtask policy of vm is JSVM_MicrotaskPolicy::JSVM_MICROTASK_AUTO.
+ *
+ * @param vm The VM instance to set mircrotasks policy.
+ * @param policy Policy for running microtasks.
+ * @return Returns JSVM_OK if the API succeeded.
+ * @since 16
+ */
+JSVM_EXTERN JSVM_Status OH_JSVM_SetMicrotaskPolicy(JSVM_VM vm,
+                                                   JSVM_MicrotaskPolicy policy);
+
 /**
  * @brief Destroys VM instance.
  *
diff --git a/ark_runtime/jsvm/jsvm_types.h b/ark_runtime/jsvm/jsvm_types.h
index 1141b051f..bca4ab893 100644
--- a/ark_runtime/jsvm/jsvm_types.h
+++ b/ark_runtime/jsvm/jsvm_types.h
@@ -770,5 +770,19 @@ typedef enum {
     /** WebAssembly cache, generated by OH_JSVM_CreateWasmCache */
     JSVM_CACHE_TYPE_WASM,
 } JSVM_CacheType;
+
+/**
+ * @brief Microtask policies of JSVM.
+ *
+ * @since 16
+ */
+typedef enum {
+    /** Microtasks are invoked with the OH_JSVM_PerformMicrotaskCheckpoint() method. */
+    JSVM_MICROTASK_EXPLICIT = 0,
+    /** Microtasks are invoked when the script call depth decrements to zero.
+     *  Default mode.
+     */
+    JSVM_MICROTASK_AUTO,
+} JSVM_MicrotaskPolicy;
 /** @} */
 #endif /* ARK_RUNTIME_JSVM_JSVM_TYPE_H */
diff --git a/ark_runtime/jsvm/libjsvm.ndk.json b/ark_runtime/jsvm/libjsvm.ndk.json
index e0157b772..69e38c4c3 100644
--- a/ark_runtime/jsvm/libjsvm.ndk.json
+++ b/ark_runtime/jsvm/libjsvm.ndk.json
@@ -734,5 +734,9 @@
     {
         "first_introduced": "12",
         "name": "OH_JSVM_ReleaseCache"
+    },
+    {
+        "first_introduced": "12",
+        "name": "OH_JSVM_SetMicrotaskPolicy"
     }
 ]
-- 
Gitee