expose a harness gc() wrapper

Signed-off-by: Balakrishna Avulapati <ba@bavulapati.com>

Author: bavulapati

eslint.config.js

@@ -15,6 +15,7 @@ export default defineConfig([
         loadAddon: "readonly",
         mustCall: "readonly",
         mustNotCall: "readonly",
+        gc: "readonly",
         gcUntil: "readonly",
         experimentalFeatures: "readonly",
         onUncaughtException: "readonly",

implementors/node/gc.js

@@ -1,13 +1,26 @@
+// Capture the engine-provided gc (Node exposes it under --expose-gc) before
+// we overwrite globalThis.gc with the harness wrapper below.
+const engineGc = globalThis.gc;
+if (typeof engineGc !== "function") {
+  throw new Error(
+    "Node harness expects globalThis.gc to be available (run with --expose-gc)",
+  );
+}
+
+const gc = () => {
+  engineGc();
+};
+
 const gcUntil = async (name, condition) => {
   let count = 0;
   while (!condition()) {
     await new Promise((resolve) => setImmediate(resolve));
     if (++count < 10) {
-      globalThis.gc();
+      engineGc();
     } else {
       throw new Error(`GC test "${name}" failed after ${count} attempts`);
     }
   }
 };
 
-Object.assign(globalThis, { gcUntil });
+Object.assign(globalThis, { gc, gcUntil });

tests/harness/gc.js

@@ -1,7 +1,14 @@
+if (typeof gc !== 'function') {
+  throw new Error('Expected a global gc function');
+}
+
 if (typeof gcUntil !== 'function') {
   throw new Error('Expected a global gcUntil function');
 }
 
+// gc should run synchronously without throwing
+gc();
+
 // gcUntil should resolve once the condition becomes true
 let count = 0;
 await gcUntil('test-passes', () => {

tests/js-native-api/test_reference/test.js

@@ -164,6 +164,5 @@ runTests();
 for (let i = 0; i < 1000; i++) {
   const wrapObject = new Object();
   test_reference.validateDeleteBeforeFinalize(wrapObject);
-  let gcCount = 1;
-  gcUntil("test", () => gcCount-- <= 0);
+  gc();
 }

tests/js-native-api/test_reference/test_finalizer.js

@@ -19,6 +19,5 @@ onUncaughtException(
       }),
     );
   }
-  let gcCount = 1;
-  await gcUntil("test", () => gcCount-- > 0);
+  gc();
 })().then(mustCall());