From 92b094e4875ebbd2f62ae5c597927a91d936bb5d Mon Sep 17 00:00:00 2001
From: LongYinan <lynweklm@gmail.com>
Date: Sun, 18 May 2025 23:16:40 +0800
Subject: [PATCH] feat(napi): new handle scope API (#2650)

---
 crates/napi/src/bindgen_runtime/js_values.rs  |   2 +
 .../src/bindgen_runtime/js_values/scope.rs    | 201 ++++++++++++++++++
 .../__tests__/__snapshots__/values.spec.ts.md |   2 +
 .../__snapshots__/values.spec.ts.snap         | Bin 6511 -> 6527 bytes
 examples/napi/__tests__/values.spec.ts        |   6 +
 examples/napi/example.wasi-browser.js         |   1 +
 examples/napi/example.wasi.cjs                |   1 +
 examples/napi/index.cjs                       |   1 +
 examples/napi/index.d.cts                     |   2 +
 examples/napi/src/lib.rs                      |   1 +
 examples/napi/src/scope.rs                    |  21 ++
 11 files changed, 238 insertions(+)
 create mode 100644 crates/napi/src/bindgen_runtime/js_values/scope.rs
 create mode 100644 examples/napi/src/scope.rs

diff --git a/crates/napi/src/bindgen_runtime/js_values.rs b/crates/napi/src/bindgen_runtime/js_values.rs
index 371db93d..0fac92d3 100644
--- a/crates/napi/src/bindgen_runtime/js_values.rs
+++ b/crates/napi/src/bindgen_runtime/js_values.rs
@@ -25,6 +25,7 @@ mod object;
 #[cfg(all(feature = "tokio_rt", feature = "napi4"))]
 mod promise;
 mod promise_raw;
+mod scope;
 #[cfg(feature = "serde-json")]
 mod serde;
 mod set;
@@ -52,6 +53,7 @@ pub use object::*;
 #[cfg(all(feature = "tokio_rt", feature = "napi4"))]
 pub use promise::*;
 pub use promise_raw::*;
+pub use scope::*;
 #[cfg(feature = "web_stream")]
 pub use stream::*;
 pub use string::*;
diff --git a/crates/napi/src/bindgen_runtime/js_values/scope.rs b/crates/napi/src/bindgen_runtime/js_values/scope.rs
new file mode 100644
index 00000000..034927fe
--- /dev/null
+++ b/crates/napi/src/bindgen_runtime/js_values/scope.rs
@@ -0,0 +1,201 @@
+use std::ptr;
+
+use crate::{check_status, sys, Env, JsValue, Result};
+
+pub struct HandleScope {
+  pub(crate) scope: sys::napi_handle_scope,
+}
+
+impl HandleScope {
+  pub fn create(env: &Env) -> Result<Self> {
+    let mut scope = ptr::null_mut();
+    check_status!(
+      unsafe { sys::napi_open_handle_scope(env.0, &mut scope) },
+      "Failed to open handle scope"
+    )?;
+    Ok(Self { scope })
+  }
+
+  pub fn run<A, T>(self, arg: A, f: impl FnOnce(A) -> Result<T>) -> Result<T>
+  where
+    A: JsValuesTuple,
+  {
+    let env = arg.env();
+    let ret = f(arg);
+    check_status!(
+      unsafe { sys::napi_close_handle_scope(env, self.scope) },
+      "Failed to close handle scope"
+    )?;
+    ret
+  }
+}
+
+pub trait JsValuesTuple {
+  fn env(&self) -> sys::napi_env;
+}
+
+impl<'env, T: JsValue<'env>> JsValuesTuple for T {
+  fn env(&self) -> sys::napi_env {
+    self.value().env
+  }
+}
+
+impl<'env, T1: JsValue<'env>, T2: JsValue<'env>> JsValuesTuple for (T1, T2) {
+  fn env(&self) -> sys::napi_env {
+    self.0.value().env
+  }
+}
+
+impl<'env, T1: JsValue<'env>, T2: JsValue<'env>, T3: JsValue<'env>> JsValuesTuple for (T1, T2, T3) {
+  fn env(&self) -> sys::napi_env {
+    self.0.value().env
+  }
+}
+
+impl<'env, T1: JsValue<'env>, T2: JsValue<'env>, T3: JsValue<'env>, T4: JsValue<'env>> JsValuesTuple
+  for (T1, T2, T3, T4)
+{
+  fn env(&self) -> sys::napi_env {
+    self.0.value().env
+  }
+}
+
+impl<
+    'env,
+    T1: JsValue<'env>,
+    T2: JsValue<'env>,
+    T3: JsValue<'env>,
+    T4: JsValue<'env>,
+    T5: JsValue<'env>,
+  > JsValuesTuple for (T1, T2, T3, T4, T5)
+{
+  fn env(&self) -> sys::napi_env {
+    self.0.value().env
+  }
+}
+
+impl<
+    'env,
+    T1: JsValue<'env>,
+    T2: JsValue<'env>,
+    T3: JsValue<'env>,
+    T4: JsValue<'env>,
+    T5: JsValue<'env>,
+    T6: JsValue<'env>,
+  > JsValuesTuple for (T1, T2, T3, T4, T5, T6)
+{
+  fn env(&self) -> sys::napi_env {
+    self.0.value().env
+  }
+}
+
+impl<
+    'env,
+    T1: JsValue<'env>,
+    T2: JsValue<'env>,
+    T3: JsValue<'env>,
+    T4: JsValue<'env>,
+    T5: JsValue<'env>,
+    T6: JsValue<'env>,
+    T7: JsValue<'env>,
+  > JsValuesTuple for (T1, T2, T3, T4, T5, T6, T7)
+{
+  fn env(&self) -> sys::napi_env {
+    self.0.value().env
+  }
+}
+
+impl<
+    'env,
+    T1: JsValue<'env>,
+    T2: JsValue<'env>,
+    T3: JsValue<'env>,
+    T4: JsValue<'env>,
+    T5: JsValue<'env>,
+    T6: JsValue<'env>,
+    T7: JsValue<'env>,
+    T8: JsValue<'env>,
+  > JsValuesTuple for (T1, T2, T3, T4, T5, T6, T7, T8)
+{
+  fn env(&self) -> sys::napi_env {
+    self.0.value().env
+  }
+}
+
+impl<
+    'env,
+    T1: JsValue<'env>,
+    T2: JsValue<'env>,
+    T3: JsValue<'env>,
+    T4: JsValue<'env>,
+    T5: JsValue<'env>,
+    T6: JsValue<'env>,
+    T7: JsValue<'env>,
+    T8: JsValue<'env>,
+    T9: JsValue<'env>,
+  > JsValuesTuple for (T1, T2, T3, T4, T5, T6, T7, T8, T9)
+{
+  fn env(&self) -> sys::napi_env {
+    self.0.value().env
+  }
+}
+
+impl<
+    'env,
+    T1: JsValue<'env>,
+    T2: JsValue<'env>,
+    T3: JsValue<'env>,
+    T4: JsValue<'env>,
+    T5: JsValue<'env>,
+    T6: JsValue<'env>,
+    T7: JsValue<'env>,
+    T8: JsValue<'env>,
+    T9: JsValue<'env>,
+    T10: JsValue<'env>,
+  > JsValuesTuple for (T1, T2, T3, T4, T5, T6, T7, T8, T9, T10)
+{
+  fn env(&self) -> sys::napi_env {
+    self.0.value().env
+  }
+}
+
+impl<
+    'env,
+    T1: JsValue<'env>,
+    T2: JsValue<'env>,
+    T3: JsValue<'env>,
+    T4: JsValue<'env>,
+    T5: JsValue<'env>,
+    T6: JsValue<'env>,
+    T7: JsValue<'env>,
+    T8: JsValue<'env>,
+    T9: JsValue<'env>,
+    T10: JsValue<'env>,
+    T11: JsValue<'env>,
+  > JsValuesTuple for (T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11)
+{
+  fn env(&self) -> sys::napi_env {
+    self.0.value().env
+  }
+}
+
+impl<
+    'env,
+    T1: JsValue<'env>,
+    T2: JsValue<'env>,
+    T3: JsValue<'env>,
+    T4: JsValue<'env>,
+    T5: JsValue<'env>,
+    T6: JsValue<'env>,
+    T7: JsValue<'env>,
+    T8: JsValue<'env>,
+    T9: JsValue<'env>,
+    T10: JsValue<'env>,
+    T11: JsValue<'env>,
+    T12: JsValue<'env>,
+  > JsValuesTuple for (T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12)
+{
+  fn env(&self) -> sys::napi_env {
+    self.0.value().env
+  }
+}
diff --git a/examples/napi/__tests__/__snapshots__/values.spec.ts.md b/examples/napi/__tests__/__snapshots__/values.spec.ts.md
index a03296e4..80be2855 100644
--- a/examples/napi/__tests__/__snapshots__/values.spec.ts.md
+++ b/examples/napi/__tests__/__snapshots__/values.spec.ts.md
@@ -824,6 +824,8 @@ Generated by [AVA](https://avajs.dev).
       value: number␊
     }␊
     ␊
+    export declare function shorterScope(arr: unknown[]): Array<number>␊
+    ␊
     export declare function shutdownRuntime(): void␊
     ␊
     export declare function spawnThreadInThread(tsfn: ((err: Error | null, arg: number) => number)): void␊
diff --git a/examples/napi/__tests__/__snapshots__/values.spec.ts.snap b/examples/napi/__tests__/__snapshots__/values.spec.ts.snap
index cfd2ad4463e85830ecf2d1ba392cffbd994afc32..e68529266037344b965d37a7eac3258954a43f7f 100644
GIT binary patch
delta 6396
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
Kc3ku-bN~R@*oV9T

delta 6382
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

diff --git a/examples/napi/__tests__/values.spec.ts b/examples/napi/__tests__/values.spec.ts
index d3fcb088..a00a5d60 100644
--- a/examples/napi/__tests__/values.spec.ts
+++ b/examples/napi/__tests__/values.spec.ts
@@ -232,6 +232,7 @@ import {
   extendsJavascriptError,
   shutdownRuntime,
   callAsyncWithUnknownReturnValue,
+  shorterScope,
 } from '../index.cjs'
 // import other stuff in `#[napi(module_exports)]`
 import nativeAddon from '../index.cjs'
@@ -1660,3 +1661,8 @@ test('extends javascript error', (t) => {
 test('module exports', (t) => {
   t.is(nativeAddon.NAPI_RS_SYMBOL, Symbol.for('NAPI_RS_SYMBOL'))
 })
+
+test('shorter scope', (t) => {
+  const result = shorterScope(['hello', { foo: 'bar' }, 'world', true])
+  t.deepEqual(result, [5, 1, 5, 0])
+})
diff --git a/examples/napi/example.wasi-browser.js b/examples/napi/example.wasi-browser.js
index e7f885c6..c42fba5b 100644
--- a/examples/napi/example.wasi-browser.js
+++ b/examples/napi/example.wasi-browser.js
@@ -292,6 +292,7 @@ export const roundtripStr = __napiModule.exports.roundtripStr
 export const runScript = __napiModule.exports.runScript
 export const setNullByteProperty = __napiModule.exports.setNullByteProperty
 export const setSymbolInObj = __napiModule.exports.setSymbolInObj
+export const shorterScope = __napiModule.exports.shorterScope
 export const shutdownRuntime = __napiModule.exports.shutdownRuntime
 export const spawnThreadInThread = __napiModule.exports.spawnThreadInThread
 export const Status = __napiModule.exports.Status
diff --git a/examples/napi/example.wasi.cjs b/examples/napi/example.wasi.cjs
index e94d7b69..53280515 100644
--- a/examples/napi/example.wasi.cjs
+++ b/examples/napi/example.wasi.cjs
@@ -316,6 +316,7 @@ module.exports.roundtripStr = __napiModule.exports.roundtripStr
 module.exports.runScript = __napiModule.exports.runScript
 module.exports.setNullByteProperty = __napiModule.exports.setNullByteProperty
 module.exports.setSymbolInObj = __napiModule.exports.setSymbolInObj
+module.exports.shorterScope = __napiModule.exports.shorterScope
 module.exports.shutdownRuntime = __napiModule.exports.shutdownRuntime
 module.exports.spawnThreadInThread = __napiModule.exports.spawnThreadInThread
 module.exports.Status = __napiModule.exports.Status
diff --git a/examples/napi/index.cjs b/examples/napi/index.cjs
index e2a9e2ed..b400ec22 100644
--- a/examples/napi/index.cjs
+++ b/examples/napi/index.cjs
@@ -606,6 +606,7 @@ module.exports.roundtripStr = nativeBinding.roundtripStr
 module.exports.runScript = nativeBinding.runScript
 module.exports.setNullByteProperty = nativeBinding.setNullByteProperty
 module.exports.setSymbolInObj = nativeBinding.setSymbolInObj
+module.exports.shorterScope = nativeBinding.shorterScope
 module.exports.shutdownRuntime = nativeBinding.shutdownRuntime
 module.exports.spawnThreadInThread = nativeBinding.spawnThreadInThread
 module.exports.Status = nativeBinding.Status
diff --git a/examples/napi/index.d.cts b/examples/napi/index.d.cts
index 027c4529..6163d2fc 100644
--- a/examples/napi/index.d.cts
+++ b/examples/napi/index.d.cts
@@ -786,6 +786,8 @@ export interface Shared {
   value: number
 }
 
+export declare function shorterScope(arr: unknown[]): Array<number>
+
 export declare function shutdownRuntime(): void
 
 export declare function spawnThreadInThread(tsfn: ((err: Error | null, arg: number) => number)): void
diff --git a/examples/napi/src/lib.rs b/examples/napi/src/lib.rs
index bca8f0b5..9ce5cad7 100644
--- a/examples/napi/src/lib.rs
+++ b/examples/napi/src/lib.rs
@@ -80,6 +80,7 @@ mod number;
 mod object;
 mod promise;
 mod reference;
+mod scope;
 mod serde;
 mod set;
 mod shared;
diff --git a/examples/napi/src/scope.rs b/examples/napi/src/scope.rs
new file mode 100644
index 00000000..0fa8fd07
--- /dev/null
+++ b/examples/napi/src/scope.rs
@@ -0,0 +1,21 @@
+use napi::{bindgen_prelude::*, JsString};
+
+#[napi]
+pub fn shorter_scope(env: &Env, arr: Array) -> Result<Vec<u32>> {
+  let len = arr.len();
+  let mut result = Vec::with_capacity(len as usize);
+  for i in 0..len {
+    let scope = HandleScope::create(env)?;
+    let value: Unknown = arr.get_element(i)?;
+    let len = scope.run(value, |v| match v.get_type()? {
+      ValueType::String => {
+        let string = unsafe { v.cast::<JsString>() }?;
+        Ok(string.utf8_len()? as u32)
+      }
+      ValueType::Object => Ok(1),
+      _ => Ok(0),
+    })?;
+    result.push(len);
+  }
+  Ok(result)
+}