Unbound script

src/api.zig

@@ -73,6 +73,7 @@ const Engine = @import("private_api.zig").Engine;
 pub const JSValue = Engine.JSValue;
 pub const JSObject = Engine.JSObject;
 pub const JSObjectID = Engine.JSObjectID;
+pub const JSScript = Engine.JSScript;
 
 pub const Callback = Engine.Callback;
 pub const CallbackSync = Engine.CallbackSync;

src/engines/v8/v8.zig

@@ -302,6 +302,33 @@ pub const Env = struct {
         }
     }
 
+    // compile a JS script
+    pub fn compile(
+        self: Env,
+        script: []const u8,
+        name: []const u8,
+    ) anyerror!JSScript {
+
+        // compile
+        const scr_name = v8.String.initUtf8(self.isolate, name);
+        const script_source = v8.String.initUtf8(self.isolate, script);
+
+        const origin = v8.ScriptOrigin.initDefault(self.isolate, scr_name.toValue());
+
+        var script_comp_source: v8.ScriptCompilerSource = undefined;
+        script_comp_source.init(script_source, origin, null);
+        defer script_comp_source.deinit();
+
+        const uboundedscript = v8.ScriptCompiler.CompileUnboundScript(
+            self.isolate,
+            &script_comp_source,
+            .kNoCompileOptions,
+            .kNoCacheNoReason,
+        ) catch return error.JSCompile;
+
+        return .{ .inner = uboundedscript };
+    }
+
     // compile and run a JS script
     // It doesn't wait for callbacks execution
     pub fn exec(
@@ -431,6 +458,23 @@ pub const JSObject = struct {
     }
 };
 
+pub const JSScript = struct {
+    inner: v8.UnboundScript,
+
+    // Bind the unbounded script to the current context and run it.
+    pub fn run(self: JSScript, env: Env) anyerror!JSValue {
+        if (env.js_ctx == null) {
+            return error.EnvNotStarted;
+        }
+
+        const scr = self.inner.bindToCurrentContext() catch return error.JSExec;
+
+        // run
+        const value = scr.run(env.js_ctx.?) catch return error.JSExec;
+        return .{ .value = value };
+    }
+};
+
 pub const JSValue = struct {
     value: v8.Value,